DesignerActionList.GetSortedActionItems Yöntem

Tanım

Ad Alanı:

System.ComponentModel.Design

Bütünleştirilmiş Kod:

System.Windows.Forms.Design.dll

Listede bulunan nesne koleksiyonunu DesignerActionItem 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

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

Örnekler

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

Bu kod örneğinin tam açıklaması için bkz. How to: Attach Smart Tags to a Windows Forms Component.

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

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

Tür	Description
DesignerActionHeaderItem	Kalın olarak görüntülenen grup etiketi.
DesignerActionTextItem	Düz yazı tipinde görüntülenen bir etiket.
DesignerActionPropertyItem	Bir özellik ile ilişkili 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, programcı tarafından sağlanan sınıfından DesignerActionList türetilen ilgili 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 sınıfına DesignerActionPropertyItem 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 özelliğine Category göre gruplandırılır:

• Karşılaşılan ilk öğenin kategorisi, ilk grubun başlangıcını gösterir. Sonraki her öğe aynı kategoride olduğu sürece bu grup 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, özelliği olarak falseayarlanmış öğeleri AllowAssociate de içerir.

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

Ayrıca bkz.

• DesignerActionItem
• Category
• AllowAssociate
• PropertyDescriptor