DependencyProperty.RegisterAttached Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert eine angefügte Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftennamen, Eigenschaftentyp, Besitzertyp und Eigenschaftenmetadaten für die Eigenschaft.
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 DependencyPropertyParameter
- name
-
String
winrt::hstring
Der Name der zu registrierenden Abhängigkeitseigenschaft.
Der Typ der Eigenschaft als Typverweis (System.Type für Microsoft .NET, eine TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX)).
Der Besitzertyp, der die Abhängigkeitseigenschaft als Typverweis registriert (System.Type für Microsoft .NET, eine TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX)).
- defaultMetadata
- PropertyMetadata
Eine eigenschaftsmetadaten-instance. Dies kann einen PropertyChangedCallback-Implementierungsverweis enthalten.
Gibt zurück
Ein Abhängigkeitseigenschaftsbezeichner, der verwendet werden soll, um den Wert eines öffentlichen statischen schreibgeschützten Felds in Ihrer Klasse festzulegen. Dieser Bezeichner wird dann verwendet, um später auf die angefügte Eigenschaft für Vorgänge zu verweisen, z. B. programmgesteuertes Festlegen des Werts oder Anfügen einer Bindung.
Beispiele
In diesem Beispiel wird eine Klasse definiert, die von DependencyObject abgeleitet wird, und eine angefügte Eigenschaft zusammen mit dem Bezeichnerfeld definiert. Das Szenario für diese Klasse ist, dass es sich um eine Dienstklasse handelt, die eine angefügte Eigenschaft deklariert, die andere UI-Elemente in XAML festlegen können, und dass der Dienst möglicherweise zur Laufzeit auf die angefügten Eigenschaftswerte für diese UI-Elemente reagiert. Weitere Beispiele finden Sie unter Benutzerdefinierte angefügte Eigenschaften.
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);
}
}