DesignerActionItem Sınıf

Tanım

Akıllı etiket panelindeki bir panel öğesini temsil eden türler için temel sınıfı sağlar.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Devralma
DesignerActionItem
Türetilmiş

Örnekler

Aşağıdaki kod örneği, nesne koleksiyonunun DesignerActionItem nasıl oluşturulacağını gösterir.

Akıllı etiketleri uygulamaya ilişkin tam bir örnek için bkz . Nasıl yapılır: Windows Forms Bileşenine Akıllı Etiketler Ekleme.

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

Açıklamalar

sınıfı, DesignerActionItem akıllı etiketler için menü benzeri bir kullanıcı arabirimini (UI) temsil eden bir akıllı etiket panelindeki tek tek panel öğelerini temsil eden sınıflar için soyut bir temel görevi görür. .NET Framework, düz metin, üst bilgi metni, ilişkili DesignerActionList sınıfın özellikleri ve yöntemleri ve tasarımcı fiilleri de dahil olmak üzere akıllı etiket panelindeki farklı ortak girişleri temsil eden türetilmiş sınıflar sağlar.

Genellikle, özelliğinizDesignerAction, akıllı etiket panelini oluşturmak için tek tek panel öğelerini gruplandıran bir GetSortedActionItems yöntem içeren programcı tarafından sağlanan sınıfında DesignerActionListtanımlanır. DesignerActionPropertyItem ve DesignerActionMethodItem türleri öğesinden DesignerActionListtüretilen sınıfın üyeleriyle ilişkilendirilir ve DesignerActionMethodItem ilişkili panel girdileri kullanıcı tarafından seçildiğinde nesneler etkinleştirilir.

Not

Formlar ve iletişim kutuları, öğesinden DesignerActionListtüretilen sınıfın üyeleri tarafından görüntülenebilir. Varsayılan olarak, bu pencerelerin üst öğesi akıllı etiket panelinin kapsayıcı penceresi olur. Bu alt pencerelerin açıkça başka bir hizmete veya pencereye üst öğe eklenmesi, öğelerin düzgün görüntülenmemelerine neden olabilir.

Oluşturucular

DesignerActionItem(String, String, String)

DesignerActionItem sınıfının yeni bir örneğini başlatır.

Özellikler

AllowAssociate

Bu öğenin aynı Category özellik değerine sahip bir öğe grubuna yerleştirilmesine izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar.

Category

Bir öğenin grup adını alır.

Description

Öğenin ek metnini alır.

DisplayName

Bu öğenin metnini alır.

Properties

Programcı tanımlı anahtar/değer çiftlerini depolamak için kullanılabilecek bir koleksiyona başvuru alır.

ShowInSourceView

Bu öğenin kaynak kod görünümünde görünüp görünmediğini belirten bir değer alır veya ayarlar.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.