CornerRadius Structure

Définition

Espace de noms:

Windows.UI.Xaml

Décrit les caractéristiques d’un coin arrondi, telles que peut être appliquée à une bordure.

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

Héritage

ValueType

CornerRadius

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple XAML montre plusieurs styles de Bordure utilisant différentes valeurs CornerRadius :

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

Le code XAML produit cette sortie rendue :

Remarques

Remarques sur la syntaxe XAML

Bien que vous puissiez spécifier un Élément CornerRadius en tant qu’élément objet, vous ne pouvez pas spécifier les valeurs individuelles telles que BottomLeft en tant qu’attributs de cet élément d’objet. L’analyseur XAML ne prend pas en charge la définition de valeurs d’attribut XAML pour cette structure. Par exemple, ce code XAML ne fonctionne pas :

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

Au lieu de cela, vous devez spécifier les valeurs en tant que texte d’initialisation dans cornerRadius. L’utilisation de la syntaxe d’élément d’objet pour un CornerRadius est utile si vous souhaitez déclarer une ressource à clé qui peut être utilisée par plusieurs instances Border pour leur Border.CornerRadius. Pour plus d’informations sur le texte d’initialisation XAML, consultez guide de syntaxe XAML.

Si vous spécifiez une chaîne d’attribut ou un texte d’initialisation avec deux ou trois valeurs, seule la première valeur est respectée et est traitée comme uniformRadius (les autres valeurs sont ignorées). Vous devez spécifier les quatre valeurs pour utiliser un comportement différent de uniformRadius.

Vous pouvez utiliser un espace plutôt qu’une virgule comme délimiteur entre les valeurs.

Cet exemple montre comment utiliser le texte d’initialisation pour définir les valeurs d’une ressource CornerRadius, puis appliquer la ressource à une bordure.

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

Projection et membres de CornerRadius

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou des extensions de composant Visual C++ (C++/CX), CornerRadius dispose de membres non-données disponibles, et ses membres de données sont exposés en tant que propriétés en lecture-écriture, et non en tant que champs. Consultez CornerRadius dans le navigateur d’API .NET.

Si vous programmez avec C++/WinRT ou la Windows Runtime bibliothèque de modèles C++ (WRL), seuls les champs membres de données existent en tant que membres de CornerRadius, et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires de la projection .NET. Le code C++ peut accéder à des méthodes utilitaires similaires qui existent dans la classe CornerRadiusHelper .

Ce tableau présente les méthodes équivalentes disponibles dans .NET et C++.

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

Champs

BottomLeft	Rayon d’arrondi, en pixels, du coin inférieur gauche de l’objet où un CornerRadius est appliqué.
BottomRight	Rayon d’arrondi, en pixels, de l’angle inférieur droit de l’objet où un CornerRadius est appliqué.
TopLeft	Rayon d’arrondi, en pixels, de l’angle supérieur gauche de l’objet où un CornerRadius est appliqué.
TopRight	Rayon d’arrondi, en pixels, de l’angle supérieur droit de l’objet où un CornerRadius est appliqué.