Shadow

.NET 多平臺應用程式 UI (.NET MAUI) Shadow 類別會在版面配置或檢視周圍繪製陰影。 類別 VisualElement 具有 Shadow 類型的 Shadow可系結屬性,可讓陰影加入任何版面配置或檢視。

類別 Shadow 會定義下列屬性:

  • Radiusfloat別為 的 ,定義用來產生陰影的模糊半徑。 此屬性的預設值為 10。
  • Opacityfloat別為 的 ,表示陰影的不透明度。 這個屬性的預設值為 1。
  • BrushBrush別 為的筆刷代表用來著色陰影的筆刷。
  • OffSet類型 Point為 的 ,指定陰影的位移,代表建立陰影的光源位置。

這些屬性是由 BindableProperty 物件所支援,這表示這些屬性可以是數據系結的目標,並設定樣式。

重要

屬性 Brush 目前僅支援 SolidColorBrush

建立陰影

若要將陰影加入控件,請將控件的 Shadow 屬性設定為 Shadow 屬性定義其外觀的物件。

下列 XAML 範例示範如何將陰影新增至 Image

<Image Source="dotnet_bot.png"
       WidthRequest="250"
       HeightRequest="310">
    <Image.Shadow>
        <Shadow Brush="Black"
                Offset="20,20"
                Radius="40"
                Opacity="0.8" />
    </Image.Shadow>
</Image>

在此範例中,黑色陰影會在影像的外框周圍繪製,其位移會指定其出現在影像的右下方:

Screenshot of an image with a shadow applied.

陰影也可以新增至裁剪的物件,如下列範例所示:

<Image Source="https://aka.ms/campus.jpg"
       Aspect="AspectFill"
       HeightRequest="220"
       WidthRequest="220"
       HorizontalOptions="Center">
    <Image.Clip>
        <EllipseGeometry Center="220,250"
                         RadiusX="220"
                         RadiusY="220" />
    </Image.Clip>
    <Image.Shadow>
        <Shadow Brush="Black"
                Offset="10,10"
                Opacity="0.8" />
    </Image.Shadow>
</Image>

在此範例中,黑色陰影會在裁剪影像的 EllipseGeometry 外框周圍繪製:

Screenshot of a clipped image with a shadow applied.

如需裁剪項目的詳細資訊,請參閱 使用 Geometry 裁剪。