語言

UIElement.Opacity 屬性

定義

取得或設定物件不透明度的度數。

public:
 property double Opacity { double get(); void set(double value); };
double Opacity();

void Opacity(double value);
public double Opacity { get; set; }
var double = uIElement.opacity;
uIElement.opacity = double;
Public Property Opacity As Double
<uiElement Opacity="double" .../>

屬性值

Double

double

一個介於 0 到 1.0 之間的值,宣告不透明度因子,其中 1.0 代表完全不透明度,0 表示透明。 預設值為 1.0。

範例

此範例使用分 鏡 與 雙動畫 來鎖定 Opacity。 這會讓應用程式 Opacity 產生專屬的裝飾淡入動畫,持續一秒鐘。

  <UserControl x:Class="animation_ovw_intro.Page"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  Width="400" Height="300">

  <StackPanel>
    <StackPanel.Resources>
      <!-- Animates the rectangle's opacity. -->
      <Storyboard x:Name="myStoryboard">
        <DoubleAnimation
          Storyboard.TargetName="MyAnimatedRectangle"
          Storyboard.TargetProperty="Opacity"
          From="1.0" To="0.0" Duration="0:0:1" 
          AutoReverse="True" 
          RepeatBehavior="Forever"/>
       </Storyboard>
    </StackPanel.Resources>
    <TextBlock Margin="10">Click on the rectangle to start the animation.</TextBlock>

    <Rectangle PointerPressed="Item_Clicked"
      x:Name="MyAnimatedRectangle"
      Width="100" Height="100" Fill="Blue" />

  </StackPanel>
</UserControl>

備註

當 Opacity 設定在巢狀物件上時,渲染的有效不透明度是所有適用不透明度因子的乘積。 例如,若一個物件Opacity=0.5包含於一個同樣Opacity=0.5為 的畫布中,則渲染的有效Opacity值為 0.25。 Opacity 大於 1.0 的值在使用該值時會被視為 1.0,儘管取得屬性值仍會得到原本大於一的值。 Opacity 設定為小於 0 的值在使用該值時視為 0。 在分解邏輯中,將 a Opacity 設為 2 以抵銷被 0.5 Opacity 物件所包含的影響是無法運作的;即使在計算巢狀物件因式分解之前,2 的值也會被視為 1.0。

Opacity 是一個有時會在視覺狀態分鏡中動畫化的屬性,且沒有任何持續時間。 例如,「FocusStates」視覺狀態的焦點矩形在原始控制模板中設定為 , Opacity="0" 因為你不希望這個矩形出現在預設的非焦點狀態。 但視覺狀態定義了一個零持續的「聚焦」狀態,當使用這些模板和狀態的控制鍵偵測到鍵盤聚焦時,不透明度會設為 1。

不透明度與碰撞測試

Opacity值為 0 並不代表物件無法被擊中測試。 這種行為對於建立 imagemap 風格的覆蓋層非常有用,這些覆蓋層會繪製在 UI 其他部分之上。 舉例來說,你可以使用一個有兩個子節點的 Canvas:一個 Rectangle,其高度、寬度和不透明度為 0,另一個是應該在下方繪製的 UI 其餘部分的 layout 根節點。 預設 Canvas 情況下,繪圖會在同一絕對座標系中重疊排列。 確保 的 RectangleZIndex 值高於其他元素ZIndex(或在 XAML 元素順序中將 在另一個元素之後宣告,Rectangle這樣會得到相同結果)。接線你的擊中測試邏輯(結合 Microsoft。UI。Xaml.Input.PointerRoutedEventArgs.GetCurrentPoint 與 VisualTreeHelper.FindElementsInHostCoordinates 到 PointerPressed 事件的 Rectangle.

或者,為了排除物件在命中測試之外,你應該將 IsHitTestVisible 設為 false,而不是使用 Opacity。

適用於

另請參閱