DesignerActionPropertyItem 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.

sınıfından DesignerActionListtüretilen 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: Object

DesignerActionItem
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: 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ı, DesignerActionPropertyItem bir akıllı etiket panelindeki tek tek öğeleri temsil eder. Her öğe genellikle sınıfından türetilen ve bileşen yazarı tarafından sağlanan bir sınıftaki DesignerActionList bir özellik ile ilişkilendirilir. İlişkilendirme özelliğinde depolandığı gibi özelliğin MemberName 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 vermesi, ilişkili özelliğin veri türü için mevcut destek türü bilgilerine bağlıdır. Aşağıdaki tabloda olası şema 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şkili tür düzenleyicisi, özelliğin değerini düzenlemek için görüntülenir.
Bilinen bir türle () ilişkili bir tür dönüştürücüsü varTypeConverter	Özelliğin değerini düzenlemek için bilinen tür için tür düzenleyicisi görüntülenir. Örneğin, 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 bir ikili 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üler ve düzenleyiciler 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: Kullanıcı Arabirimi Türü Düzenleyici 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 metni ile 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 koleksiyon başvurusu 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