UIElement.Opacity 속성

정의

UIElementUI (사용자 인터페이스)에서 렌더링 될 때 전체에 적용 되는 불투명도 요소를 가져오거나 설정 합니다.Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the user interface (UI). 이 속성은 종속성 속성입니다.This is a dependency property.

public:
 property double Opacity { double get(); void set(double value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Opacity { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Opacity : double with get, set
Public Property Opacity As Double

속성 값

Double

불투명도 요소입니다.The opacity factor. 기본 불투명도는 1.0입니다.Default opacity is 1.0. 예상 값은 0.0에서 1.0 사이입니다.Expected values are between 0.0 and 1.0.

특성

설명

1.0 기본값은 클래스에서이 종속성 속성의 초기 메타 데이터에서 제공 하는 기본 값입니다 UIElement .The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. 다른 파생 클래스는 해당 클래스 생성자 내에서 메타 데이터를 재정의 하 여이 기본값을 변경할 수 있습니다.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

Opacity요소가 표시 되는 경우 (가 인 경우)에는의 값이 실제 레이아웃에 적용 되지 않습니다 IsVisible true .The value of Opacity won't be applied to actual layout unless the element is also visible (IsVisible is true).

Opacity 는 요소 트리의 부모 요소에서 자식 요소로 적용 되지만 중첩 된 불투명도 설정의 표시 효과는 개별 자식 요소의 속성 값에 표시 되지 않습니다.Opacity is applied from parent elements on down the element tree to child elements, but the visible effects of the nested opacity settings aren't indicated in the property value of individual child elements. 예를 들어 목록의 불투명도가 50% (0.5)이 고 목록 항목 중 하나에 자체 불투명도가 20% (0.2)로 설정 된 경우 해당 목록 항목의 순으로 보이는 불투명도가 10% (0.1) 인 것 처럼 렌더링 되지만 목록 항목 속성의 속성 값은 Opacity 계속 해 서 쿼리할 0.2 수 있습니다.For instance, if a list has a 50% (0.5) opacity and one of its list items has its own opacity set to 20% (0.2), the net visible opacity for that list item will be rendered as if it were 10% (0.1), but the property value of the list item Opacity property would still be 0.2 when queried.

선언 된 불투명도 또는 계산 된 불투명도가 0 인 경우에도 요소는 입력 이벤트와 명령에 계속 참여 하 고 잠재적으로 잠재적으로 잠재적으로 발생할 수 있습니다.Even if the declared or evaluated opacity is 0, an element still participates in input events and commands, and is potentially focusable. 이러한 측면에서 유용할 수 있습니다. 예를 들어 투명 한 요소를 사용 하 여 기본 개체를 마스킹 하기 위해 불투명 제로 개체 (예: 도형)를 사용할 수 있습니다.This aspect can be useful, for instance you can use an opacity-zero object (such as a shape) for masking underlying objects with transparent elements. 그러면 불투명 제로 개체가 내부 영역에 대 한 모든 입력 이벤트 처리를 처리할 수 있습니다.The opacity-zero object can then handle all the input event processing for an underlying area. 그러나 Background Fill 개체 또는 셰이프의 또는가 인 경우에도 값으로 설정 되어야 합니다 Transparent . 그렇지 않으면 적중 테스트를 사용할 수 없으며 이벤트가 수신 되지 않습니다.However, the Background or Fill of the object or shape should be set to a value, even if it is Transparent, otherwise hit testing is not enabled, and no events are received.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field OpacityProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보