DependencyProperty.RegisterAttached Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Zaregistruje připojenou vlastnost v systému vlastností.

Přetížení

RegisterAttached(String, Type, Type)	Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.
RegisterAttached(String, Type, Type, PropertyMetadata)	Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Zaregistruje připojenou vlastnost se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření hodnoty pro vlastnost.

RegisterAttached(String, Type, Type)

Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType);

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

static member RegisterAttached : string * Type * Type -> System.Windows.DependencyProperty

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

Parametry

name

String

Název vlastnosti závislosti, která se má zaregistrovat.

propertyType

Type

Typ proměnné

ownerType

Type

Typ vlastníka, který registruje vlastnost závislosti.

Návraty

DependencyProperty

Identifikátor vlastnosti závislosti, který by se měl použít k nastavení hodnoty public static readonly pole ve třídě. Tento identifikátor se pak použije k pozdějšímu odkazu na vlastnost závislostí pro operace, jako je nastavení jeho hodnoty programově nebo získání metadat.

Příklady

Následující příklad zaregistruje připojenou vlastnost v abstraktní třídě pomocí tohoto RegisterAttached podpisu.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Poznámky

Připojená vlastnost je koncept vlastnosti definovaný jazykem XAML (Extensible Application Markup Language). WPF implementuje připojené vlastnosti jako vlastnosti závislostí. Vzhledem k tomu, že připojené vlastnosti WPF jsou vlastnosti závislostí, mohou mít použitá metadata, která lze použít obecným systémem vlastností pro operace, jako jsou charakteristiky rozložení sestav. Další informace najdete v tématu Přehled připojených vlastností.

Další informace o registraci vlastností závislostí najdete v tématu DependencyProperty.

Viz také

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

RegisterAttached(String, Type, Type, PropertyMetadata)

Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);

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

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty

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

Parametry

name

String

Název vlastnosti závislosti, která se má zaregistrovat.

propertyType

Type

Typ proměnné

ownerType

Type

Typ vlastníka, který registruje vlastnost závislosti.

defaultMetadata

PropertyMetadata

Metadata vlastností pro vlastnost závislosti To může zahrnovat výchozí hodnotu i další charakteristiky.

Návraty

DependencyProperty

Identifikátor vlastnosti závislosti, který by se měl použít k nastavení hodnoty public static readonly pole ve třídě. Tento identifikátor se pak použije k pozdějšímu odkazu na vlastnost závislostí pro operace, jako je nastavení jeho hodnoty programově nebo získání metadat.

Poznámky

Připojená vlastnost je koncept vlastnosti definovaný jazykem XAML (Extensible Application Markup Language). WPF implementuje připojené vlastnosti jako vlastnosti závislostí. Vzhledem k tomu, že připojené vlastnosti WPF jsou vlastnosti závislostí, mohou mít použitá metadata, která lze použít obecným systémem vlastností pro operace, jako jsou charakteristiky rozložení sestav. Další informace najdete v tématu Přehled připojených vlastností.

Další informace o registraci vlastností závislostí najdete v tématu DependencyProperty.

Použití registerAttached pro vlastnosti závislostí dědění hodnot

Jedním z konkrétních scénářů pro registraci vlastnosti RegisterAttached závislostí místo Register toho, aby podporoval dědičnost hodnot vlastností. Vlastnosti závislostí RegisterAttached zděděné hodnotou byste měli zaregistrovat i v případě, že třída definuje objekty obálky vlastností, které zpřístupňují vlastnost závislostí, a to i v případě, že nemáte v úmyslu zveřejnit statické metody Get* a Set*, aby poskytovaly přístupové objekty podpory true připojených vlastností. I když se může zdát, že dědičnost hodnot vlastností může fungovat pro neattachované vlastnosti závislostí, chování dědičnosti pro neattachovanou vlastnost prostřednictvím určitých hranic prvků ve stromu modulu runtime není definováno. Registrace vlastnosti jako připojené efektivně vytvoří připojenou vlastnost globální vlastnost systému vlastností a zajišťuje, že dědičnost hodnot vlastností funguje napříč všemi hranicemi ve stromu prvků. Vždy se používá RegisterAttached k registraci vlastností, ve kterých zadáte Inherits metadata. Další informace naleznete v tématu Dědičnost hodnot vlastností.

Viz také

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Zaregistruje připojenou vlastnost se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření hodnoty pro vlastnost.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

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

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty

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

Parametry

name

String

Název vlastnosti závislosti, která se má zaregistrovat.

propertyType

Type

Typ proměnné

ownerType

Type

Typ vlastníka, který registruje vlastnost závislosti.

defaultMetadata

PropertyMetadata

Metadata vlastností pro vlastnost závislosti To může zahrnovat výchozí hodnotu i další charakteristiky.

validateValueCallback

ValidateValueCallback

Odkaz na zpětné volání, který by měl provádět jakékoli vlastní ověření hodnoty vlastnosti závislosti nad rámec typického ověřování typu.

Návraty

DependencyProperty

Identifikátor vlastnosti závislosti, který by se měl použít k nastavení hodnoty public static readonly pole ve třídě. Tento identifikátor se pak použije k pozdějšímu odkazu na vlastnost závislostí pro operace, jako je nastavení jeho hodnoty programově nebo získání metadat.

Příklady

Následující příklad zaregistruje připojenou vlastnost v abstraktní třídě pomocí tohoto RegisterAttached podpisu. Tato připojená vlastnost je vlastnost typu výčtu a registrace přidá ověřovací zpětné volání k ověření, že zadaná hodnota je hodnota výčtu.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Poznámky

Připojená vlastnost je koncept vlastnosti definovaný jazykem XAML (Extensible Application Markup Language). WPF implementuje připojené vlastnosti jako vlastnosti závislostí. Vzhledem k tomu, že připojené vlastnosti WPF jsou vlastnosti závislostí, mohou mít použitá metadata, která lze použít obecným systémem vlastností pro operace, jako jsou charakteristiky rozložení sestav. Další informace najdete v tématu Přehled připojených vlastností.

Další informace o registraci vlastností závislostí najdete v tématu DependencyProperty.

Použití registerAttached pro vlastnosti závislostí dědění hodnot

Jedním z konkrétních scénářů pro registraci vlastnosti RegisterAttached závislostí místo Register toho, aby podporoval dědičnost hodnot vlastností. Vlastnosti závislostí RegisterAttached zděděné hodnotou byste měli zaregistrovat i v případě, že třída definuje objekty obálky vlastností, které zpřístupňují vlastnost závislostí, a to i v případě, že nemáte v úmyslu zveřejnit statické metody Get* a Set*, aby poskytovaly přístupové objekty podpory true připojených vlastností. I když se může zdát, že dědičnost hodnot vlastností může fungovat pro neattachované vlastnosti závislostí, chování dědičnosti pro neattachovanou vlastnost prostřednictvím určitých hranic prvků ve stromu modulu runtime není definováno. Registrace vlastnosti jako připojené efektivně vytvoří připojenou vlastnost globální vlastnost systému vlastností a zajišťuje, že dědičnost hodnot vlastností funguje napříč všemi hranicemi ve stromu prvků. Vždy se používá RegisterAttached k registraci vlastností, ve kterých zadáte Inherits metadata. Další informace naleznete v tématu Dědičnost hodnot vlastností.

Viz také

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)