DesignerActionList.GetSortedActionItems Yöntem
Tanım
Ö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.
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
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 . 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 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şkilendirilmiş 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, sınıfından türetilen DesignerActionList 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 bir 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ı belirtir. Bu grup, başarılı olan 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, özelliği olarak
false
ayarlanmış öğeleri AllowAssociate de içerir.
GetSortedActionItems Panel ilk oluşturulduğunda yöntemi çağrılır. Panelde Refresh görüntülenen öğelerin listesini güncelleştirmek için yöntemini çağırmanız gerekir.
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin