DesignerActionItem Sınıf

Başvuru

Tanım

Ad Alanı:: System.ComponentModel.Design

Bütünleştirilmiş Kod:: System.Design.dll

Bütünleştirilmiş Kod:: System.Windows.Forms.Design.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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: Object
DesignerActionItem

Türetilmiş: System.ComponentModel.Design.DesignerActionMethodItem

System.ComponentModel.Design.DesignerActionPropertyItem

System.ComponentModel.Design.DesignerActionTextItem

Ö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: Akıllı Etiketleri Windows Forms Bileşenine 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 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

Forms ve iletişim kutuları, sınıfından 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