DependencyProperty.RegisterAttached Metoda

Definice

Obor názvů:: System.Windows

Sestavení:: WindowsBase.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

Name	Description
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 vlastnosti.

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 vaší třídě. Tento identifikátor se pak použije k pozdějšímu odkazu na vlastnost závislosti pro operace, jako je například nastavení jeho hodnoty prostřednictvím kódu programu 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 (Windows Presentation Foundation) implementuje připojené vlastnosti jako vlastnosti závislosti. Vzhledem k tomu, že připojené vlastnosti WPF (Windows Presentation Foundation) jsou vlastnosti závislosti, mohou mít použitá metadata, která lze použít systémem obecných vlastností pro operace, jako jsou charakteristiky rozložení sestav. Další informace najdete v přehledu přidružených vlastností.

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

Viz také

Platí pro

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

ownerType: Type

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

defaultMetadata: PropertyMetadata

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

Návraty

DependencyProperty

Poznámky

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

Použití funkce RegisterAttached pro vlastnosti závislosti dědění hodnot

Jedním konkrétním scénářem registrace vlastnosti RegisterAttached závislosti místo Register toho je podpora dědičnosti hodnot vlastností. Vlastnosti RegisterAttached závislostí, které dědí hodnoty, byste měli zaregistrovat i v případě, že třída definuje obálky vlastností, které zpřístupňují vlastnost závislostí, a dokonce i v případě, že nemáte v úmyslu vystavit Get* a Set* statické metody, které poskytují skutečné připojené vlastnosti podporují přístupové objekty. I když se může zdát, že dědičnost hodnot vlastností může fungovat pro neapojené vlastnosti závislostí, chování dědičnosti pro neopojenou vlastnost prostřednictvím určitých hranic prvků ve stromu modulu runtime není definováno. Registrace vlastnosti, která je připojena efektivně, způsobí, že připojená vlastnost je 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 použijte RegisterAttached k registraci vlastností, pokud v metadatech zadáváte Inherits. Další informace naleznete v tématu Dědičnost hodnot vlastností.

Viz také

Platí pro

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

ownerType: Type

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

defaultMetadata: PropertyMetadata

Metadata vlastností vlastnosti 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ést jakékoli vlastní ověření hodnoty vlastnosti závislosti nad rámec typického ověřování typu.

Návraty

DependencyProperty

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á zpětná volání pro ověření, zda 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

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

Použití funkce RegisterAttached pro vlastnosti závislosti dědění hodnot

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?