CornerRadius Struktur

Definisi

Ruang nama:

Windows.UI.Xaml

Menjelaskan karakteristik sudut bulat, seperti dapat diterapkan ke Batas.

public value class CornerRadius

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct CornerRadius

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct CornerRadius

Public Structure CornerRadius

<CornerRadius>uniformRadius</CornerRadius>
-or-
<CornerRadius>topLeft,topRight,bottomRight,bottomLeft</CornerRadius>
- or -
<object property="uniformRadius"/>
- or -
<object property="topLeft,topRight,bottomRight,bottomLeft"/>

Warisan

ValueType

CornerRadius

Atribut

ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh XAML ini memperlihatkan beberapa gaya Batas menggunakan nilai CornerRadius yang berbeda:

<StackPanel>
    <Border Height="30" Width="200" CornerRadius="0"
     BorderThickness="2" BorderBrush="Red" Margin="5">
        <TextBlock>CornerRadius: 0</TextBlock>
    </Border>
    <Border Height="30" Width="200" CornerRadius="5"
     BorderThickness="2" BorderBrush="Red" Margin="5">
        <TextBlock>CornerRadius: 5</TextBlock>
    </Border>
    <Border Height="30" Width="200" CornerRadius="5,0,5,0"
     BorderThickness="2" BorderBrush="Red" Margin="5">
        <TextBlock>CornerRadius: 5,0,5,0</TextBlock>
    </Border>
    <Border Height="30" Width="200" CornerRadius="5,5,0,0"
     BorderThickness="2" BorderBrush="Red" Margin="5">
        <TextBlock>CornerRadius: 5,5,0,0</TextBlock>
    </Border>
</StackPanel>

XAML menghasilkan output yang dirender ini:

Keterangan

Catatan tentang sintaks XAML

Meskipun Anda dapat menentukan CornerRadius sebagai elemen objek, Anda tidak dapat menentukan nilai individual seperti BottomLeft sebagai atribut elemen objek tersebut. Parser XAML tidak mendukung pengaturan nilai atribut XAML untuk struktur ini. Misalnya, XAML ini tidak berfungsi:

<!-- THIS DOES NOT WORK -->
<CornerRadius x:Key="CornerRadiusError" BottomLeft="20"/>

Sebagai gantinya, Anda harus menentukan nilai sebagai teks inisialisasi dalam CornerRadius. Menggunakan sintaks elemen objek untuk CornerRadius berguna jika Anda ingin mendeklarasikan sumber daya kunci yang dapat digunakan oleh beberapa instans Batas untuk Border.CornerRadius. Untuk informasi selengkapnya tentang teks inisialisasi XAML, lihat panduan sintaks XAML.

Jika Anda menentukan string atribut atau teks inisialisasi dengan dua atau tiga nilai, hanya nilai pertama yang dihormati dan diperlakukan sebagai uniformRadius (nilai lainnya diabaikan). Anda harus menentukan keempat nilai untuk menggunakan perilaku yang berbeda dari uniformRadius.

Anda dapat menggunakan spasi daripada koma sebagai pemisah di antara nilai.

Contoh ini memperlihatkan cara menggunakan teks inisialisasi untuk mengatur nilai sumber daya CornerRadius, lalu menerapkan sumber daya ke Batas.

<Page.Resources>
    <CornerRadius x:Key="CornerRadius4010">40,10,40,10</CornerRadius>
</Page.Resources>

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Border BorderBrush="Blue" BorderThickness="2"
            CornerRadius="{StaticResource CornerRadius4010}"/>
</Grid>

Proyeksi dan anggota CornerRadius

Jika Anda menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic), atau ekstensi komponen Visual C++ (C++/CX), maka CornerRadius memiliki anggota non-data yang tersedia, dan anggota datanya diekspos sebagai properti baca-tulis, bukan bidang. Lihat CornerRadius di Browser .NET API.

Jika Anda memprogram dengan C++/WinRT atau Windows Runtime C++ Template Library (WRL), maka hanya bidang anggota data yang ada sebagai anggota CornerRadius, dan Anda tidak dapat menggunakan metode utilitas atau properti proyeksi .NET. Kode C++ dapat mengakses metode utilitas serupa yang ada di kelas CornerRadiusHelper .

Tabel ini memperlihatkan metode yang setara yang tersedia di .NET dan C++.

.NET (CornerRadius)	C++ (CornerRadiusHelper)
CornerRadius(Ganda)	FromUniformRadius(Double)
CornerRadius(Ganda, Ganda, Ganda, Ganda)	FromRadii(Double, Double, Double, Double)

Bidang

BottomLeft	Radius pembulatan, dalam piksel, sudut kiri bawah objek tempat CornerRadius diterapkan.
BottomRight	Radius pembulatan, dalam piksel, sudut kanan bawah objek tempat CornerRadius diterapkan.
TopLeft	Radius pembulatan, dalam piksel, sudut kiri atas objek tempat CornerRadius diterapkan.
TopRight	Radius pembulatan, dalam piksel, sudut kanan atas objek tempat CornerRadius diterapkan.