DesignerActionPropertyItem Classe
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un elemento pannello associato a una proprietà in una classe derivata da DesignerActionList. La classe non può essere ereditata.
public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem
public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem
type DesignerActionPropertyItem = class
inherit DesignerActionItem
Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem
- Ereditarietà
Nell'esempio di codice seguente viene illustrato come creare una raccolta di DesignerActionItem oggetti . Per un esempio completo dell'implementazione di smart tag, vedere Procedura: Collegare smart tag a un componente Windows Form.
public override DesignerActionItemCollection GetSortedActionItems()
{
DesignerActionItemCollection items = new DesignerActionItemCollection();
//Define static section header entries.
items.Add(new DesignerActionHeaderItem("Appearance"));
items.Add(new DesignerActionHeaderItem("Information"));
//Boolean property for locking color selections.
items.Add(new DesignerActionPropertyItem("LockColors",
"Lock Colors", "Appearance",
"Locks the color properties."));
if (!LockColors)
{
items.Add(new DesignerActionPropertyItem("BackColor",
"Back Color", "Appearance",
"Selects the background color."));
items.Add(new DesignerActionPropertyItem("ForeColor",
"Fore Color", "Appearance",
"Selects the foreground color."));
//This next method item is also added to the context menu
// (as a designer verb).
items.Add(new DesignerActionMethodItem(this,
"InvertColors", "Invert Colors",
"Appearance",
"Inverts the fore and background colors.",
true));
}
items.Add(new DesignerActionPropertyItem("Text",
"Text String", "Appearance",
"Sets the display text."));
//Create entries for static Information section.
StringBuilder location = new StringBuilder("Location: ");
location.Append(colLabel.Location);
StringBuilder size = new StringBuilder("Size: ");
size.Append(colLabel.Size);
items.Add(new DesignerActionTextItem(location.ToString(),
"Information"));
items.Add(new DesignerActionTextItem(size.ToString(),
"Information"));
return items;
}
Public Overrides Function GetSortedActionItems() _
As DesignerActionItemCollection
Dim items As New DesignerActionItemCollection()
'Define static section header entries.
items.Add(New DesignerActionHeaderItem("Appearance"))
items.Add(New DesignerActionHeaderItem("Information"))
'Boolean property for locking color selections.
items.Add(New DesignerActionPropertyItem( _
"LockColors", _
"Lock Colors", _
"Appearance", _
"Locks the color properties."))
If Not LockColors Then
items.Add( _
New DesignerActionPropertyItem( _
"BackColor", _
"Back Color", _
"Appearance", _
"Selects the background color."))
items.Add( _
New DesignerActionPropertyItem( _
"ForeColor", _
"Fore Color", _
"Appearance", _
"Selects the foreground color."))
'This next method item is also added to the context menu
' (as a designer verb).
items.Add( _
New DesignerActionMethodItem( _
Me, _
"InvertColors", _
"Invert Colors", _
"Appearance", _
"Inverts the fore and background colors.", _
True))
End If
items.Add( _
New DesignerActionPropertyItem( _
"Text", _
"Text String", _
"Appearance", _
"Sets the display text."))
'Create entries for static Information section.
Dim location As New StringBuilder("Location: ")
location.Append(colLabel.Location)
Dim size As New StringBuilder("Size: ")
size.Append(colLabel.Size)
items.Add( _
New DesignerActionTextItem( _
location.ToString(), _
"Information"))
items.Add( _
New DesignerActionTextItem( _
size.ToString(), _
"Information"))
Return items
End Function
La DesignerActionPropertyItem classe rappresenta i singoli elementi in un pannello smart tag. Ogni elemento è in genere associato a una proprietà in una classe derivata dalla DesignerActionList classe e fornita dall'autore del componente. L'associazione viene mantenuta tramite il nome della proprietà, come archiviato nella MemberName proprietà .
I singoli elementi del pannello sono associati per formare un pannello tramite una chiamata al GetSortedActionItems metodo della DesignerActionList classe .
Per visualizzare il valore della proprietà associata, tale proprietà deve avere un get
metodo di funzione di accesso. Per consentire la modifica, la proprietà deve disporre di un set
metodo di funzione di accesso. Il modo in cui il pannello consente la modifica diretta di un elemento di proprietà da parte dell'utente dipende dalle informazioni sul tipo di supporto presenti per il tipo di dati della proprietà associata. La tabella seguente illustra lo schema probabile.
Informazioni sul tipo di proprietà | Elemento proprietà che modifica l'interfaccia utente |
---|---|
Dispone di un editor di tipi associato (UITypeEditor) | L'editor dei tipi associato alla proprietà sottostante viene visualizzato per modificare il valore della proprietà. |
Dispone di un convertitore di tipi associato a un tipo noto (TypeConverter) | L'editor dei tipi per il tipo noto viene visualizzato per modificare il valore della proprietà. Ad esempio, un convertitore di tipi per String visualizzerà probabilmente un oggetto TextBox. |
Valore booleano | L'elemento viene visualizzato usando un'interfaccia utente binaria, ad esempio un segno di spunta. |
Nessuna delle opzioni precedenti. | L'elemento viene visualizzato come stringa di testo non modificabile usando il metodo del tipo di ToString dati. |
Tutti i tipi fondamentali, ad esempio System.Boolean, e i tipi di dati comuni di .NET Framework, ad esempio System.String, forniscono convertitori di tipi standard e editor. Per altre informazioni sui convertitori di tipi, vedere Procedura: Implementare un convertitore di tipi o una conversione di tipi generalizzati. Per altre informazioni sugli editor di tipi, vedere Procedura: Implementare un editor di tipi di interfaccia utente.
Designer |
Inizializza una nuova istanza della classe DesignerActionPropertyItem con i nomi di proprietà e i nomi visualizzati specificati. |
Designer |
Inizializza una nuova istanza della classe DesignerActionPropertyItem, con i nomi di proprietà, di categoria e il testo visualizzato specificati. |
Designer |
Inizializza una nuova istanza della classe DesignerActionPropertyItem, con i nomi di proprietà e di categoria specificati, nonché il testo della descrizione e quello visualizzato. |
Allow |
Ottiene o imposta un valore che indica se consentire il posizionamento di questo elemento in un gruppo di elementi con lo stesso valore per la proprietà Category. (Ereditato da DesignerActionItem) |
Category |
Ottiene il nome del gruppo per un elemento. (Ereditato da DesignerActionItem) |
Description |
Ottiene il testo aggiuntivo per l'elemento. (Ereditato da DesignerActionItem) |
Display |
Ottiene il testo per l'elemento. (Ereditato da DesignerActionItem) |
Member |
Ottiene il nome della proprietà a cui è associato l'elemento. |
Properties |
Ottiene un riferimento a un insieme che può essere utilizzato per memorizzare coppie chiave/valore definite dal programmatore. (Ereditato da DesignerActionItem) |
Related |
Ottiene o imposta un componente che rende disponibili i propri elementi al pannello corrente. |
Show |
Ottiene o imposta un valore che indica se questo elemento compare nella visualizzazione del codice sorgente. (Ereditato da DesignerActionItem) |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Get |
Funge da funzione hash predefinita. (Ereditato da Object) |
Get |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
Memberwise |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
To |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Prodotto | Versioni |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: