DesignerActionPropertyItem Sınıf

Tanım

öğesinden DesignerActionListtüretilen bir sınıftaki bir özellik ile ilişkili bir panel öğesini temsil eder. Bu sınıf devralınamaz.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem
public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem
type DesignerActionPropertyItem = class
    inherit DesignerActionItem
Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem
Devralma
DesignerActionPropertyItem

Ö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ı, DesignerActionPropertyItem bir akıllı etiket panelindeki tek tek öğeleri temsil eder. Her öğe genellikle sınıfından DesignerActionList türetilen ve bileşen yazarı tarafından sağlanan bir sınıftaki bir özellik ile ilişkilendirilir. İlişkilendirme özelliğinde depolandığı MemberName gibi özelliğin adıyla korunur.

Tek tek panel öğeleri, sınıfın yöntemine DesignerActionList yapılan bir çağrıyla bir panel oluşturmak için GetSortedActionItems birlikte ilişkilendirilir.

İlişkili özelliğin değerini görüntülemek için bu özelliğin bir get erişimci yöntemi olmalıdır; düzenlemeye izin vermek için özelliğin bir set erişimci yöntemi olmalıdır. Panelin bir özellik öğesinin kullanıcı tarafından doğrudan düzenlenmesine izin verme şekli, ilişkili özelliğin veri türü için mevcut destek türü bilgilerine bağlıdır. Aşağıdaki tabloda olası düzen gösterilmektedir.

Özellik türü bilgileri Özellik öğesi düzenleme kullanıcı arabirimi (UI)
İlişkili bir tür düzenleyicisi (UITypeEditor) var Temel alınan özellik ile ilişkilendirilmiş tür düzenleyicisi, özelliğin değerini düzenlemek için görüntülenir.
Bilinen bir türle (TypeConverter) ilişkilendirilmiş bir tür dönüştürücüsü vardır Özelliğin değerini düzenlemek için bilinen türün tür düzenleyicisi görüntülenir. Örneğin, için bir tür dönüştürücüsü String büyük olasılıkla bir TextBoxgörüntüler.
Boole değeri Öğe, onay işareti gibi ikili bir kullanıcı arabirimi kullanılarak görüntülenir.
Yukarıdakilerin hiçbiri. Öğe, veri türünün ToString yöntemi kullanılarak düzenlenemez bir metin dizesi olarak görüntülenir.

gibi System.Booleantüm temel türler ve gibi System.Stringyaygın .NET Framework veri türleri, standart tür dönüştürücüleri ve düzenleyicileri sağlar. Tür dönüştürücüleri hakkında daha fazla bilgi için bkz . Nasıl yapılır: Tür Dönüştürücüsü Uygulama veya Genelleştirilmiş Tür Dönüştürme. Tür düzenleyicileri hakkında daha fazla bilgi için bkz . Nasıl yapılır: Ui Tür Düzenleyicisi Uygulama.

Oluşturucular

DesignerActionPropertyItem(String, String)

Belirtilen özellik ve görünen adlarla sınıfının yeni bir örneğini DesignerActionPropertyItem başlatır.

DesignerActionPropertyItem(String, String, String)

Belirtilen özellik ve kategori adlarıyla sınıfının yeni bir örneğini DesignerActionPropertyItem başlatır ve metin görüntüler.

DesignerActionPropertyItem(String, String, String, String)

Belirtilen özellik ve kategori adları ve görüntüleme ve açıklama metniyle sınıfının yeni bir örneğini DesignerActionPropertyItem 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.

(Devralındığı yer: DesignerActionItem)
Category

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

(Devralındığı yer: DesignerActionItem)
Description

Öğenin ek metnini alır.

(Devralındığı yer: DesignerActionItem)
DisplayName

Bu öğenin metnini alır.

(Devralındığı yer: DesignerActionItem)
MemberName

Bu öğenin ilişkili olduğu özelliğin adını alır.

Properties

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

(Devralındığı yer: DesignerActionItem)
RelatedComponent

Öğelerini geçerli panele katkıda bulunan bir bileşeni alır veya ayarlar.

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.

(Devralındığı yer: DesignerActionItem)

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.