DependencyProperty.RegisterAttached Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml

Inscrit une propriété de dépendance jointe avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés pour la propriété.

 static DependencyProperty RegisterAttached(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& defaultMetadata);

public static DependencyProperty RegisterAttached(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata defaultMetadata);

function registerAttached(name, propertyType, ownerType, defaultMetadata)

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

Paramètres

name

String

winrt::hstring

Nom de la propriété de dépendance à inscrire.

propertyType

TypeName Type

Type de la propriété, en tant que référence de type (System.Type pour Microsoft .NET, struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).

ownerType

TypeName Type

Type de propriétaire qui inscrit la propriété de dépendance en tant que référence de type (System.Type pour Microsoft .NET, struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).

defaultMetadata

PropertyMetadata

Une instance de métadonnées de propriété. Il peut contenir une référence d’implémentation PropertyChangedCallback .

Retours

DependencyProperty

Identificateur de propriété de dépendance qui doit être utilisé pour définir la valeur d’un champ public statique en lecture seule dans votre classe. Cet identificateur est ensuite utilisé pour référencer la propriété jointe ultérieurement, pour des opérations telles que la définition de sa valeur par programme ou l’attachement d’une liaison.

Exemples

Cet exemple définit une classe qui dérive de DependencyObject et définit une propriété jointe avec le champ identificateur. Le scénario de cette classe est qu’il s’agit d’une classe de service qui déclare une propriété jointe que d’autres éléments d’interface utilisateur peuvent définir en XAML, et que le service agit potentiellement sur les valeurs de propriété attachées sur ces éléments d’interface utilisateur au moment de l’exécution. Pour plus d’exemples, consultez Propriétés jointes personnalisées.

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy { Floats, Sinks, Drifts }

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

Voir aussi

• Propriétés jointes personnalisées
• Vue d’ensemble des propriétés de dépendance
• Vue d’ensemble des propriétés jointes