FrameworkContentElement.Style 속성

정의

이 요소에서 사용할 스타일을 가져오거나 설정합니다.Gets or sets the style to be used by this element.

public:
 property System::Windows::Style ^ Style { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style Style { get; set; }
member this.Style : System.Windows.Style with get, set
Public Property Style As Style

속성 값

Style

있는 경우 요소에 대해 적용된 기본값이 아닌 스타일입니다.The applied, nondefault style for the element, if present. 그렇지 않으면 null입니다.Otherwise, null. 기본 생성된 FrameworkContentElement의 기본값은 null입니다.The default for a default-constructed FrameworkContentElement is null.

예제

다음 예제에서는 Resources 루트 요소에 대해 컬렉션을 설정 FlowDocument 하 고이를의 특정 스타일로 리소스로 참조 합니다 Paragraph .The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a Paragraph.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

설명

현재 스타일 리소스가 페이지나 애플리케이션 수준 (암시적 스타일)에서 해당 형식의 개체에 일반적으로 적용 되는 스타일 또는 테마에서 기본 스타일에 의해 자주 제공 됩니다.The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). 이 속성은 기본 (테마) 스타일을 설정 하거나 반환 하지 않지만 암시적 스타일 또는 명시적 스타일을 반환 합니다.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. 암시적 또는 명시적 스타일의 경우 스타일을 리소스로 액세스 하거나 로컬로 정의 하는지 여부는 중요 하지 않습니다.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

스타일 설정에는 몇 가지 제한 사항이 있습니다.Setting the styles has some restrictions. 언제 든 지 전체 속성을 새으로 다시 설정 하 여 Style Style 레이아웃 다시 컴퍼지션을 강제로 적용할 수 있습니다.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. 그러나 로드 된 요소에 의해 해당 스타일이 사용 되는 즉시는 sealed로 간주 되어야 합니다 Style .However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. 사용 중인 스타일의 개별 속성 (예: 컬렉션 내 모든 항목)을 변경 하려고 Setters 하면 예외가 throw 됩니다.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. 태그에 정의 된 스타일은 리소스 사전에서 로드 되는 즉시 사용 중인 것으로 간주 되거나 (리소스의 경우), 인라인 스타일의 경우 포함 된 페이지가 로드 되는 즉시 사용 중인 것으로 간주 됩니다.A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Style 는 특별 한 우선 순위의 종속성 속성입니다.Style is a dependency property with special precedence. 로컬에 설정 된 스타일은 일반적으로 속성 시스템에서 가장 높은 우선 순위로 작동 합니다.The locally set style generally operates at the highest precedence in the property system. Style이 시점에서이 null 인 경우 속성 시스템은 해당 형식을 지정 하는 정의 된 리소스로 암시적 스타일을 확인 합니다.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. 이 단계를 수행한 후 스타일이 여전히 null 이면 스타일은 기본 (테마) 스타일에서 제공 되지만 기본 스타일은 속성 값에 반환 되지 않습니다 Style .If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. 종속성 속성 값 우선 순위를 참조 하세요.See Dependency Property Value Precedence.

XAML 특성 사용XAML Attribute Usage

<object Style="{resourceExtension StyleResourceKey}"/>  

XAML 값XAML Values

resourceExtensionresourceExtension
다음 중 하나: , 또는 합니다.One of the following: , or . 참조 XAML 리소스합니다.See XAML Resources.

styleResourceKeystyleResourceKey
요청 되는 스타일을 식별 하는 키입니다.The key that identifies the style being requested. 키의 기존 리소스에 참조를 ResourceDictionary입니다.The key refers to an existing resource in a ResourceDictionary.

참고

속성 요소 구문은 기술적으로 가능 하지만 권장 하지는 않습니다.Property element syntax is technically possible, but not recommended. 참조 인라인 스타일 및 템플릿합니다.See Inline Styles and Templates. TemplateBinding 또는를 사용 하는 바인딩 참조 Binding 도 가능 하지만 일반적이 지 않습니다.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field StyleProperty
메타 데이터 속성 설정 trueMetadata properties set to true AffectsMeasure

적용 대상