UIElement.Opacity 속성


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

 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; }
member this.Opacity : double with get, set
Public Property Opacity As 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. 이러한 측면은 투명 요소를 사용 하 여 기본 개체를 마스킹에 대 한 불투명도 0 인 개체 (예: 모양)를 사용할 수는 예를 들어 유용할 수 있습니다.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. 불투명도 0 인 개체는 기본 영역에 대 한 처리 모든 입력된 이벤트를 처리한 다음 수 있습니다.The opacity-zero object can then handle all the input event processing for an underlying area. 그러나 개체 또는 셰이프의 Background 또는 FillTransparent경우에도 값으로 설정 해야 합니다. 그렇지 않으면 적중 테스트를 사용할 수 없으며 이벤트가 수신 되지 않습니다.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

적용 대상

추가 정보