Atributy doby návrhu pro komponenty

Pokud nejste obeznámeni s použití atributů zadání metadat do společného jazykového modulu runtime naleznete v tématu Rozšíření atributy metadat pomocí.Protože součásti lze zobrazit v návrháři, jako například , atributy, které obsahují metadata návrhu nástroje vyžadují.Tato část popisuje a poskytuje seznam běžně používaných atributů návrhu.

Atributy a podpora Designer

Atributy návrhu jsou nezbytné pro správné zobrazení ovládacího prvku a jeho členů v době návrhu, jako poskytují cenné informace pro nástroj pro vizuální návrhy.

V následující fragment kódu CategoryAttribute atribut umožňuje prohlížeči vlastností zobrazení TextAlignment vlastnost zarovnání kategorie.DescriptionAttribute atribut umožňuje prohlížeči vlastností poskytnout stručný popis vlastnosti při klepnutí na něj.

[
Category("Alignment"),
Description("Specifies the alignment of text.")
]
public ContentAlignment TextAlignment { //... }

<Category("Alignment"), _
Description("Specifies the alignment of text.")> _
Public Property _
TextAlignment As ContentAlignment
   ' ...
End Property

[!POZNÁMKA]

V a , o třídu atributu s názvem Název_atributuatribut lze odkazovat pouze jako Název_atributu syntaxe atributu.

Některé atributy návrhu jsou použity na úrovni třídy.A DesignerAttribute atribut je použit na úrovni třídy a informuje Návrhář formuláře návrháře třídu, které slouží k zobrazení ovládacího prvku.Součásti, které jsou spojeny s výchozí designer (System.ComponentModel.Design.ComponentDesigner) a model Windows Forms a ovládací prvky serveru jsou spojeny s vlastní výchozí návrháři.Použít DesignerAttribute pouze v případě, že definovat vlastní Návrhář komponenty nebo ovládacího prvku.

// Associates the designer class SimpleControl.Design.SimpleDesigner
// with Simple.
[ Designer(typeof(SimpleControl.Design.SimpleDesigner))]
    public class Simple : WebControl { //... }

' Associates the designer class SimpleControl.Design.SimpleDesigner
' with Simple.
<Designer(GetType(SimpleControl.Design.SimpleDesigner))> _
Public Class Simple
    Inherits WebControl
    ' ...
End Class

Společné atributy vlastnosti a události

V následující tabulce jsou uvedeny atributy, které jsou běžně použity vlastnosti a události.

Atribut	U	Description
BrowsableAttribute	Vlastnosti a události	Určuje, zda má být vlastnost nebo událost zobrazena v prohlížeči vlastností.
CategoryAttribute	Vlastnosti a události	Určuje název kategorie, do které skupiny vlastnost nebo událost.Při použití kategorie součásti vlastnosti a události lze zobrazit v logických seskupení v prohlížeči vlastností.
DescriptionAttribute	Vlastnosti a události	Určuje text zobrazený v dolní části prohlížeče vlastnosti, když uživatel vybere vlastnost nebo událost malý blok.
BindableAttribute	Vlastnosti	Určuje, zda je vlastnost zajímavé svázat.
DefaultPropertyAttribute	Vlastnosti (Vložte tento atribut před deklaraci třídy.)	Určuje výchozí vlastnost komponenty.Tato vlastnost je vybrán v prohlížeči vlastností při klepnutí na ovládací prvek.
DefaultValueAttribute	Vlastnosti	Nastaví jednoduché výchozí hodnotu pro vlastnost.
EditorAttribute	Vlastnosti	Editor pro úpravy (Změna) určuje vlastnost vizuální návrháře.
LocalizableAttribute	Vlastnosti	Určuje, že vlastnost je možné lokalizovat.Všechny vlastnosti, které mají tento atribut jsou trvalé do souboru zdroje automaticky, když uživatel vybere k lokalizaci formuláře.
DesignerSerializationVisibilityAttribute	Vlastnosti	Určuje, zda (a jak) vlastnosti se zobrazí v prohlížeči vlastností by trvala do kódu.
TypeConverterAttribute	Vlastnosti	Určuje typ převaděč pro převod na jiný typ dat typ vlastnosti.
DefaultEventAttribute	Události (Vložte tento atribut před deklaraci třídy.)	Určuje výchozí událost pro komponentu.Toto je událost, když uživatel klepne na komponentu vybranou v prohlížeči vlastností.

Není uvedeno jinak, atributy vlastnosti a události jsou umístěny v kódu bezprostředně před prohlášení vlastnost nebo událost, jak ukazuje následující příklad.

// To apply CategoryAttribute to the BorderColor 
// property, place it immediately before the declaration
// of the BorderColor property.
[Category("Appearance")] 
public Color BorderColor;

// To apply DescriptionAttribute to the Click event, 
// place it immediately before the declaration
// of the Click event.
[Description("The Click event of the button")]
public event EventHandler Click;

' To apply CategoryAttribute  to the BorderColor 
' property, place it before the property declaration.
<Category("Appearance")> Public BorderColor As Color

' To apply DescriptionAttribute to the Click event, 
' place it before the event declaration.
<Description("The Click event of the button")> Public Event Click

Informace o návrhu atributy, které návrháři přidružit komponent a ovládacích prvků, Rozšíření podpory během návrhu.

Kromě použití atributů tříd definovaných v knihovna tříd můžete definovat vlastní atribut třídy.Podrobnosti naleznete v dokumentaci pro programovací jazyk nebo viz Zápis vlastních atributů.

Viz také

Úkoly

Postupy: Použití atributů v ovládacích prvcích Windows Forms

Koncepty

Atributy a podpora při návrhu

Atributy v ovládacích prvcích Windows Forms

Další zdroje

Rozšíření podpory během návrhu