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.

öğ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: 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: 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

Aracılığıyla paylaş