Udostępnij za pomocą

Atrybuty w kontrolkach formularzy systemu Windows

Program .NET Framework udostępnia różne atrybuty, które można zastosować do elementów członkowskich niestandardowych kontrolek i składników. Niektóre z tych atrybutów wpływają na zachowanie klasy w czasie wykonywania, a inne na zachowanie w czasie projektowania.

Ostrzeżenie

Ta zawartość została napisana dla programu .NET Framework. Jeśli używasz platformy .NET 6 lub nowszej wersji, użyj tej zawartości ostrożnie. System projektanta został zmieniony dla formularzy Windows i ważne jest, aby przejrzeć zmiany projektanta zgodnie z artykułem .NET Framework.

Atrybuty właściwości kontrolki i komponentu

W poniższej tabeli przedstawiono atrybuty, które można zastosować do właściwości lub innych elementów członkowskich niestandardowych kontrolek i składników. Aby zapoznać się z przykładem, który używa wielu z tych atrybutów, zobacz Instrukcje: stosowanie atrybutów w kontrolkach formularzy systemu Windows.

Atrybut Opis
AmbientValueAttribute Określa wartość, która ma być przekazywana do właściwości, aby spowodować, że właściwość pobierze jej wartość z innego źródła. Jest to znane jako nastrój .
BrowsableAttribute Określa, czy właściwość lub zdarzenie powinny być wyświetlane w oknie właściwości .
CategoryAttribute Określa nazwę kategorii, w której należy zgrupować właściwość lub zdarzenie, gdy jest wyświetlane w kontrolce PropertyGrid ustawionej na tryb Categorized.
DefaultValueAttribute Określa wartość domyślną właściwości.
DescriptionAttribute Określa opis właściwości lub zdarzenia.
DisplayNameAttribute Określa nazwę wyświetlaną dla właściwości, zdarzenia lub metody public void, które nie przyjmują żadnych argumentów.
EditorAttribute Określa edytor do zmiany właściwości.
EditorBrowsableAttribute Określa, że właściwość lub metoda jest widoczna w edytorze.
HelpKeywordAttribute Określa słowo kluczowe kontekstu dla danej klasy lub składowej.
LocalizableAttribute Określa, czy właściwość ma być zlokalizowana.
PasswordPropertyTextAttribute Wskazuje, że reprezentacja tekstu obiektu jest zasłonięta znakami, takimi jak gwiazdki.
ReadOnlyAttribute Określa, czy właściwość, z którą ten atrybut jest powiązany, jest tylko do odczytu, czy do odczytu i zapisu w czasie projektowania.
RefreshPropertiesAttribute Wskazuje, że siatka właściwości powinna zostać odświeżona po zmianie skojarzonej wartości właściwości.
TypeConverterAttribute Określa typ, który ma być używany jako konwerter dla obiektu, z jakim jest powiązany ten atrybut.

Atrybuty właściwości powiązania danych

W poniższej tabeli przedstawiono atrybuty, które można zastosować, aby określić sposób interakcji niestandardowych kontrolek i składników z powiązaniem danych.

Atrybut Opis
BindableAttribute Określa, czy właściwość jest zwykle używana do celów wiązania.
ComplexBindingPropertiesAttribute Określa właściwości źródła danych i elementu członkowskiego danych dla składnika.
DefaultBindingPropertyAttribute Określa domyślną właściwość powiązania składnika.
LookupBindingPropertiesAttribute Określa właściwości źródła danych i elementu członkowskiego danych dla składnika.
AttributeProviderAttribute Włącza przekierowywanie atrybutów.

Atrybuty dla klas

W poniższej tabeli przedstawiono atrybuty, które można zastosować, aby określić zachowanie niestandardowych kontrolek i składników w czasie projektowania.

Atrybut Opis
DefaultEventAttribute Określa domyślne zdarzenie dla składnika.
DefaultPropertyAttribute Określa właściwość domyślną składnika.
DesignerAttribute Określa klasę używaną do implementowania usług czasu projektowania dla składnika.
DesignerCategoryAttribute Określa, że projektant klasy należy do określonej kategorii.
ToolboxItemAttribute Reprezentuje atrybut elementu przybornika.
ToolboxItemFilterAttribute Określa ciąg filtru i typ filtru do użycia w elemencie Przybornika.

Zobacz także

  • Last updated on