다음을 통해 공유

Setter.Value 속성

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml
편집

Setter에서 지정한 속성에 적용할 값을 가져오거나 설정합니다.

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };
IInspectable Value();

void Value(IInspectable value);
public object Value { get; set; }
var object = setter.value;
setter.value = object;
Public Property Value As Object
<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

속성 값

Object

Platform::Object

IInspectable

Setter에서 지정한 속성에 적용할 값입니다.

설명

XAML 구문에서 볼 수 있듯이 XAML에서 Setter에 대해 을 지정 Value 하는 다양한 방법이 있습니다.

  • 특성으로 문자열 값을 사용합니다. 이러한 문자열 값은 숫자 값 설정, 열거형의 명명된 값 또는 URI(Uniform Resource Identifier)와 같은 간단한 경우 속성별 형식으로 암시적으로 변환할 수 있습니다.
  • XAML 개체 요소 구문에 선언되고 개체 요소가 속성 요소 사용량 내에 중첩되는 완전한 새 개체입니다.
  • 따옴표 내에 {StaticResource} 태그 확장 사용이 있는 특성입니다. 일반적으로 속성의 값 형식은 적절한 구문을 지정합니다. XAML 사용에 대한 자세한 내용은 XAML 개요 또는 XAML 구문 가이드를 참조하세요. 대부분의 XAML UI 속성에 특성 구문을 사용할 수 있으며, 특히 속성 요소 사용 또는 리소스 참조가 필요한 UI 속성은 덜 일반적입니다. 해당 값이 둘 이상의 스타일 또는 속성에서 공유되는 경우 문자열 또는 숫자 값에도 {StaticResource} 태그 확장 사용이 적합할 수 있습니다.

Setter에서 속성과 Value 속성을 모두 지정해야 합니다. 그렇지 않으면 예외가 throw됩니다(가 XAML에서 만들어지거나 코드에서 수정되었는지 여부에 Setter 따라 구문 분석 예외 또는 런타임 오류).

코드를 사용하여 Setter instance 액세스하는 경우 부모 Styletrue의 IsSealed 속성 Setter 값이 인 경우 instance 속성의 값을 변경할 수 없습니다. 이는 개별 Setter의 IsSealed 속성에서도 보고됩니다. 시스템은 런타임이 UI 요소에 true 스타일을 적용하고 UI에 표시할 때 이러한 속성을 로 설정합니다. 봉인된 Setter 를 변경하려고 시도하면 런타임 오류가 발생합니다.

스타일 및 템플릿

Style에서 Setter를 사용하여 종속성 속성에 값을 적용할 수 있습니다. Setter 그러나 일반적인 Style에서 XAML 태그의 대부분을 구성하는 Control 파생 클래스의 Template 속성에 대한 입니다. 에 Property="Template" 대한 는 SetterValue 거의 항상 ControlTemplate 개체 요소를 포함하는 속성 요소로 지정됩니다.

Style을 사용하여 컨트롤 템플릿을 정의하는 경우 요소의 StyleTargetType과 Control.Template setter에 대한 ControlTemplate 요소의 TargetType은 항상 동일한 값을 사용해야 합니다.

템플릿 setter는 해당 템플릿이 적용되는 컨트롤 instance 대한 기본 템플릿 UI 정의를 정의합니다. 또한 컨트롤에 대한 시각적 상태와 기본 테마 전환과 같은 기타 상태 기반 UI 정의도 포함됩니다. ListBox와 같은 복잡한 컨트롤의 경우 기본 템플릿 스타일 및 내 ControlTemplate에는 수백 줄의 XAML이 있을 수 있습니다. 컨트롤 템플릿 시나리오에서 의 Style 역할에 대한 자세한 내용은 XAML 컨트롤 템플릿을 참조하세요.

적용 대상