DesignerActionPropertyItem Kelas

Referensi

Definisi

Ruang nama:: System.ComponentModel.Design

Rakitan:: System.Design.dll

Rakitan:: System.Windows.Forms.Design.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili item panel yang terkait dengan properti di kelas yang berasal dari DesignerActionList. Kelas ini tidak dapat diwariskan.

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

Warisan: Object

DesignerActionItem
DesignerActionPropertyItem

Contoh

Contoh kode berikut menunjukkan cara membuat kumpulan DesignerActionItem objek. Untuk contoh lengkap penerapan tag pintar, lihat Cara: Melampirkan Tag Pintar ke Komponen Formulir Windows.

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

Keterangan

Kelas DesignerActionPropertyItem mewakili item individual di panel tag pintar. Setiap item biasanya dikaitkan dengan properti di kelas yang berasal dari DesignerActionList kelas dan disediakan oleh pembuat komponen. Asosiasi dipertahankan melalui nama properti , seperti yang disimpan di MemberName properti .

Item panel individual dikaitkan bersama untuk membentuk panel dengan panggilan ke GetSortedActionItems metode DesignerActionList kelas .

Untuk menampilkan nilai properti terkait, properti tersebut harus memiliki get metode pengaktif; untuk mengizinkan pengeditan, properti harus memiliki set metode pengaktif. Cara panel memungkinkan pengeditan langsung item properti oleh pengguna tergantung pada informasi jenis pendukung yang ada untuk jenis data properti terkait. Tabel berikut ini memperlihatkan skema yang mungkin.

Informasi jenis properti	Item properti yang mengedit antarmuka pengguna (UI)
Memiliki editor jenis terkait (UITypeEditor)	Editor jenis yang terkait dengan properti yang mendasar ditampilkan untuk mengedit nilai properti.
Memiliki pengonversi jenis terkait ke jenis yang diketahui (TypeConverter)	Editor jenis untuk jenis yang diketahui ditampilkan untuk mengedit nilai properti. Misalnya, pengonversi jenis ke String kemungkinan akan menampilkan TextBox.
Nilai Boolean	Item ditampilkan menggunakan UI biner, seperti tanda centang.
Tidak satu pun di atas.	Item ditampilkan sebagai string teks yang tidak dapat diedit menggunakan metode jenis ToString data.

Semua jenis dasar, seperti System.Boolean, dan jenis data .NET Framework umum, seperti System.String, menyediakan pengonversi dan editor jenis standar. Untuk informasi selengkapnya tentang pengonversi jenis, lihat Cara: Menerapkan Pengonversi Tipe atau Konversi Tipe Umum. Untuk informasi selengkapnya tentang editor jenis, lihat Cara: Menerapkan Editor Jenis UI.

Konstruktor

DesignerActionPropertyItem(String, String)	Menginisialisasi instans DesignerActionPropertyItem baru kelas, dengan properti dan nama tampilan yang ditentukan.
DesignerActionPropertyItem(String, String, String)	Menginisialisasi instans DesignerActionPropertyItem baru kelas, dengan properti dan nama kategori yang ditentukan, dan menampilkan teks.
DesignerActionPropertyItem(String, String, String, String)	Menginisialisasi instans DesignerActionPropertyItem baru kelas, dengan nama properti dan kategori yang ditentukan, serta teks tampilan dan deskripsi.

Properti

AllowAssociate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengizinkan item ini ditempatkan ke dalam sekelompok item yang memiliki nilai properti yang sama Category . (Diperoleh dari DesignerActionItem)
Category	Mendapatkan nama grup untuk item. (Diperoleh dari DesignerActionItem)
Description	Mendapatkan teks tambahan untuk item. (Diperoleh dari DesignerActionItem)
DisplayName	Mendapatkan teks untuk item ini. (Diperoleh dari DesignerActionItem)
MemberName	Mendapatkan nama properti yang terkait dengan item ini.
Properties	Mendapatkan referensi ke koleksi yang dapat digunakan untuk menyimpan pasangan kunci/nilai yang ditentukan programmer. (Diperoleh dari DesignerActionItem)
RelatedComponent	Mendapatkan atau mengatur komponen yang menyumbangkan itemnya ke panel saat ini.
ShowInSourceView	Mendapatkan atau mengatur nilai yang menunjukkan apakah item ini muncul dalam tampilan kode sumber. (Diperoleh dari DesignerActionItem)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui