DesignerActionList.GetSortedActionItems Yöntem

Tanım

Ad Alanı:

System.ComponentModel.Design

Bütünleştirilmiş Kod:

System.Windows.Forms.Design.dll

Listede yer alan DesignerActionItem nesneleri koleksiyonunu döndürür.

public:
 virtual System::ComponentModel::Design::DesignerActionItemCollection ^ GetSortedActionItems();

public virtual System.ComponentModel.Design.DesignerActionItemCollection GetSortedActionItems ();

abstract member GetSortedActionItems : unit -> System.ComponentModel.Design.DesignerActionItemCollection
override this.GetSortedActionItems : unit -> System.ComponentModel.Design.DesignerActionItemCollection

Public Overridable Function GetSortedActionItems () As DesignerActionItemCollection

Döndürülenler

DesignerActionItemCollection

Bu listedeki öğeleri içeren bir DesignerActionItem dizisi.

Örnekler

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

Bu kod örneğinin tam açıklaması 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

virtual GetSortedActionItems yöntemi, beklenen görüntüleme sırasına göre DesignerActionItem sınıfından türetilen bir nesne koleksiyonu döndürmek için uygulanır. Bu öğeler aşağıdaki belirli türlerden olabilir.

Tür	Tarif
DesignerActionHeaderItem	Kalın olarak görüntülenen grup etiketi.
DesignerActionTextItem	Düz yazı tipinde görüntülenen etiket.
DesignerActionPropertyItem	Bir özellik ile ilişkilendirilmiş bir panel öğesi. Ayrıca, temel alınan özellikle ilişkili bir onay işareti veya özellik düzenleyicisi de görüntüleyebilir.
DesignerActionMethodItem	Köprü olarak görüntülenen ve bir yöntemle ilişkilendirilmiş bir panel öğesi.

Her DesignerActionMethodItem ve DesignerActionPropertyItemiçin, DesignerActionList sınıfından türetilen programcı tarafından sağlanan sınıfa karşılık gelen bir yöntem veya özellik eklenmelidir. Her yöntem ve özellik öğesi etkin giriş olarak görüntülenir; kullanıcı arabirimi (UI) aracılığıyla etkileşime geçmek, sırasıyla ilgili yöntemi veya özelliği çağırır.

Özellik öğeleri, ilgili özellik değerlerinin görüntülenmesini ve değiştirilmesini sağlayan özel bir panel-öğe arabirimine sahiptir. Daha fazla bilgi için DesignerActionPropertyItem sınıfına bakın.

Döndürülen dizideki öğelerin sırası, panelde görünecekleri sırayı yansıtır. Öğeler, aşağıdaki kurallar kullanılarak Category özelliğine göre gruplandırılır:

• Karşılaşılan ilk öğenin kategorisi, ilk grubun başlangıcını gösterir. Bu grup, sonraki her öğe aynı kategoride olduğu sürece devam eder. Farklı bir kategorideki bir öğeyle karşılaşıldığında, yeni bir grup oluşturulur ve öğe buna yerleştirilir.

• Bir öğenin türü geçerli gruptan farklıysa ancak bu kategori zaten kullanılmışsa, öğe eşleşen mevcut kategoriye yerleştirilir.

• Bir öğenin kategorisi yoksa, panelin sonundaki çeşitli bir gruba yerleştirilir. Bu grup, AllowAssociate özelliği falseolarak ayarlanmış öğeleri de içerir.

panel ilk oluşturulduğunda GetSortedActionItems yöntemi çağrılır. Panelde görüntülenen öğelerin listesini güncelleştirmek için Refresh yöntemini çağırmanız gerekir.

Ayrıca bkz.

• DesignerActionItem
• Category
• AllowAssociate
• PropertyDescriptor