DesignerActionItem Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece a classe base para tipos que representam um elemento de painel num painel de etiquetas inteligentes.
public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
- Herança
-
DesignerActionItem
- Derivado
Exemplos
O exemplo de código seguinte demonstra como criar uma coleção de DesignerActionItem objetos.
Para um exemplo completo de implementação de smart tags, veja Como: Anexar Smart Tags a um componente Windows Forms.
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
Observações
A DesignerActionItem classe serve como uma base abstrata para classes que representam elementos individuais de painéis num painel de etiquetas inteligentes, que representa uma interface de utilizador (UI) semelhante a um menu para etiquetas inteligentes. .NET Framework fornece classes derivadas que representam as diferentes entradas comuns num painel de etiquetas inteligentes, incluindo texto simples, texto do cabeçalho, propriedades e métodos da classe associada DesignerActionList e verbos designer.
Normalmente, a sua DesignerAction funcionalidade é definida numa classe fornecida pelo programador derivada de DesignerActionList, que contém um GetSortedActionItems método que agrupa elementos individuais do painel para formar o painel de etiquetas inteligentes. Os DesignerActionPropertyItem tipos e DesignerActionMethodItem estão associados a membros da classe derivada de DesignerActionList, e DesignerActionMethodItem os objetos são ativados quando a entrada do painel associada é selecionada pelo utilizador.
Note
Formulários e caixas de diálogo podem ser exibidos por membros da classe derivada de DesignerActionList. Por defeito, o pai destas janelas será a janela do contentor para o painel de etiquetas inteligentes. Criar explicitamente estas janelas filhas para outro serviço ou janela pode fazer com que os itens sejam apresentados de forma incorreta.
Construtores
| Name | Description |
|---|---|
| DesignerActionItem(String, String, String) |
Inicializa uma nova instância da DesignerActionItem classe. |
Propriedades
| Name | Description |
|---|---|
| AllowAssociate |
Recebe ou define um valor que indica se permite que este item seja colocado num grupo de itens que têm o mesmo Category valor de propriedade. |
| Category |
Obtém o nome do grupo de um item. |
| Description |
Recebe o texto suplementar do item. |
| DisplayName |
Recebe o texto deste item. |
| Properties |
Obtém uma referência a uma coleção que pode ser usada para armazenar pares chave/valor definidos pelo programador. |
| ShowInSourceView |
Recebe ou define um valor que indica se este item aparece na vista do código-fonte. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |