Gölge

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) Shadow sınıfı bir düzenin veya görünümün çevresinde bir gölge çizer. VisualElement sınıfı, herhangi bir düzen veya görünüme gölge eklenmesini sağlayan Shadowtüründe bir Shadow bağlanabilir özelliğine sahiptir.

Shadow sınıfı aşağıdaki özellikleri tanımlar:

• floattüründe Radius, gölgeyi oluşturmak için kullanılan bulanıklaştırmanın yarıçapını tanımlar. Bu özelliğin varsayılan değeri 10'dur.
• floattüründe Opacity, gölgenin opaklığını gösterir. Bu özelliğin varsayılan değeri 1'dir.
• Brushtüründe Brush, gölgeyi renklendirmek için kullanılan fırçayı temsil eder.
• Pointtüründe Offset, gölgeyi oluşturan ışık kaynağının konumunu temsil eden gölgenin uzaklığını belirtir.

Bu özellikler BindableProperty nesneler tarafından desteklenir; bu da veri bağlamalarının hedefleri olabileceği ve stillendirilebileceği anlamına gelir.

Önemli

Brush özelliği şu anda yalnızca bir SolidColorBrushdestekler.

Gölge Oluşturma

Denetime gölge eklemek için, denetimin Shadow özelliğini gölgeyi tanımlayan biçimlendirilmiş bir dize olarak ayarlayın. Desteklenen üç dize biçimi vardır:

• color, offset X, offset Y:

  <Image Source="dotnet_bot.png"
         WidthRequest="250"
         HeightRequest="310"
         Shadow="#000000 4 4" />
  

• offset X, offset Y, radius, color:

  <Image Source="dotnet_bot.png"
         WidthRequest="250"
         HeightRequest="310"
         Shadow="5 8 8 rgb(6, 201, 198)" />    
  

• offset X, offset Y, radius, color, opacity:

  <Image Source="dotnet_bot.png"
         WidthRequest="250"
         HeightRequest="310"
         Shadow="4 4 16 AliceBlue 0.5" />
  

Renkler aşağıdaki biçimler kullanılarak belirtilebilir:

Biçim	Örnek	Yorum
ONALTILIK	#rgb, #argb, #rrggbb, #aarrggbb
RGB	rgb(255,0,0), rgb(100%,0%,0%)	Geçerli değerler 0-255 veya 0%-100%aralığındadır.
RGBA	rgba(255, 0, 0, 0.8), rgba(100%, 0%, 0%, 0.8)	Geçerli opaklık değerleri 0,0-1,0'dır.
HSL	hsl(120, 100%, 50%)	h için geçerli değerler 0-360 ve s ve l için 0%-100%'dır.
HSLA	hsla(120, 100%, 50%, .8)	Geçerli opaklık değerleri 0,0-1,0'dır.
HSV	hsv(120, 100%, 50%)	h için geçerli değerler 0-360 ve s ve v için 0%-100%'dır.
HSVA	hsva(120, 100%, 50%, .8)	Geçerli opaklık değerleri 0,0-1,0'dır.
Önceden tanımlanmış renk	fuchsia, AquaMarine, limegreen	Renk dizgeleri büyük/küçük harfe duyarlı değildir.

Alternatif olarak, denetimin Shadow özelliği, özellikleri görünümünü tanımlayan özellik öğesi söz dizimi kullanılarak bir Shadow nesnesine ayarlanabilir.

Aşağıdaki XAML örneğinde, özellik öğesi söz dizimi kullanılarak bir Image'a nasıl gölge ekleneceği gösterilmektedir.

<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>

Bu örnekte, görüntünün ana hattının çevresine siyah bir gölge boyanır ve gölgenin uzaklığı, görüntünün sağında ve altında görüneceğini belirtir.

Gölgeler, aşağıdaki örnekte gösterildiği gibi kırpılmış nesnelere de eklenebilir:

<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>

Bu örnekte, resmi kırpan EllipseGeometry ana hattının etrafına siyah gölge çizilir:

Bir öğeyi kırpma hakkında daha fazla bilgi için bkz. Geometriile Kırpma.