CornerRadius Struktur

Definition

Beschreibt die Eigenschaften einer abgerundeten Ecke, z. B. auf einen Rahmen angewendet werden können.

public value class CornerRadius
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
struct CornerRadius
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 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"/>
Vererbung
CornerRadius
Attribute

Beispiele

In diesem XAML-Beispiel werden verschiedene Rahmenarten mit unterschiedlichen CornerRadius-Werten gezeigt:

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

Der XAML-Code erzeugt diese gerenderte Ausgabe:

gerenderte Ausgabe von CornerRadius-XAML-Beispiel

Hinweise

Hinweise zur XAML-Syntax

Obwohl Sie ein CornerRadius Objektelement angeben können, können Sie die einzelnen Werte wie BottomLeft Attribute dieses Objektelements nicht angeben. Der XAML-Parser unterstützt das Festlegen von XAML-Attributwerten für diese Struktur nicht. Dieser XAML-Code funktioniert beispielsweise nicht:

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

Stattdessen müssen Sie die Werte als Initialisierungstext innerhalb der CornerRadius. Die Verwendung der Objektelementsyntax für eine CornerRadius ist nützlich, wenn Sie eine Schlüsselressource deklarieren möchten, die von mehreren Rahmeninstanzen für ihr Border.CornerRadius verwendet werden kann. Weitere Informationen zum XAML-Initialisierungstext finden Sie in der XAML-Syntaxanleitung.

Wenn Sie eine Attributzeichenfolge oder einen Initialisierungstext mit zwei oder drei Werten angeben, wird nur der erste Wert berücksichtigt und als uniformRadius behandelt (die anderen Werte werden ignoriert). Sie müssen alle vier Werte angeben, um ein anderes Verhalten als uniformRadius zu verwenden.

Sie können ein Leerzeichen anstelle eines Kommas als Trennzeichen zwischen Werten verwenden.

In diesem Beispiel wird gezeigt, wie Initialisierungstext verwendet wird, um die Werte einer CornerRadius Ressource festzulegen, und dann die Ressource auf einen Rahmen anwenden.

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

Projektion und Member von CornerRadius

Wenn Sie C# verwenden, steht CornerRadius nicht-Datenmber zur Verfügung, und seine Datenmmber werden als Eigenschaften mit Lese-/Schreibzugriff verfügbar gemacht, nicht als Felder. Siehe CornerRadius im .NET-API-Browser.

Wenn Sie mit C++/WinRT oder der Windows-Runtime C++-Vorlagenbibliothek (WRL) programmieren, sind nur die Datenmemberfelder als Member von CornerRadius vorhanden, und Sie können die Hilfsmethoden oder -eigenschaften der .NET-Projektion nicht verwenden. C++-Code kann auf ähnliche Hilfsmethoden zugreifen, die in der CornerRadiusHelper-Klasse vorhanden sind.

Diese Tabelle enthält die entsprechenden Methoden, die in .NET und C++ verfügbar sind.

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

Felder

Name Beschreibung
BottomLeft

Der Radius des Rundens in Pixeln der unteren linken Ecke des Objekts, auf das ein CornerRadius Objekt angewendet wird.

BottomRight

Der Radius des Rundens in Pixeln der unteren rechten Ecke des Objekts, auf das ein CornerRadius Objekt angewendet wird.

TopLeft

Der Radius des Rundens in Pixeln der oberen linken Ecke des Objekts, auf das ein CornerRadius Objekt angewendet wird.

TopRight

Der Radius des Rundens in Pixeln der oberen rechten Ecke des Objekts, auf das ein CornerRadius Objekt angewendet wird.

Gilt für: