CMFCPropertyGridProperty kelas

Objek CMFCPropertyGridProperty mewakili item daftar dalam kontrol daftar properti.

Untuk detail selengkapnya, lihat kode sumber yang mfc terletak di folder penginstalan Visual Studio Anda. Contohnya,%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaks

class CMFCPropertyGridProperty : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCPropertyGridProperty::CMFCPropertyGridProperty	Membuat CMFCPropertyGridProperty objek.
CMFCPropertyGridProperty::~CMFCPropertyGridProperty	Destruktor.

Metode Publik

Nama	Deskripsi
CMFCPropertyGridProperty::AddOption	Menambahkan item daftar baru ke kontrol daftar properti.
CMFCPropertyGridProperty::AddSubItem	Menambahkan item anak ke properti.
CMFCPropertyGridProperty::AdjustButtonRect	Dipanggil oleh kontrol daftar properti induk untuk memberi tahu properti untuk mengubah ukuran persegi panjang pembatas tombol yang disematkan.
CMFCPropertyGridProperty::AdjustInPlaceEditRect	Mengambil batas kotak teks dan kontrol tombol putar opsional yang digunakan untuk mengatur nilai properti.
CMFCPropertyGridProperty::AllowEdit	Membuat properti dapat diedit atau baca-saja.
CMFCPropertyGridProperty::CreateInPlaceEdit	Dipanggil oleh kerangka kerja untuk membuat kontrol yang dapat diedit untuk properti.
CMFCPropertyGridProperty::CreateSpinControl	Dipanggil oleh kerangka kerja untuk membuat kontrol tombol putar yang dapat diedit.
CMFCPropertyGridProperty::Enable	Mengaktifkan atau menonaktifkan properti.
CMFCPropertyGridProperty::EnableSpinControl	Mengaktifkan atau menonaktifkan kontrol tombol putar yang digunakan untuk mengubah nilai properti.
CMFCPropertyGridProperty::Expand	Memperluas atau menciutkan properti yang berisi subproperti.
CMFCPropertyGridProperty::FormatProperty	Memformat representasi teks dari nilai properti.
CMFCPropertyGridProperty::GetData	Mengambil nilai DWORD yang terkait dengan properti.
CMFCPropertyGridProperty::GetDescription	Mengambil deskripsi properti.
CMFCPropertyGridProperty::GetExpandedSubItems	Mengambil jumlah subitem yang diperluas.
CMFCPropertyGridProperty::GetHierarchyLevel	Mengambil indeks berbasis nol dari tingkat hierarki properti.
CMFCPropertyGridProperty::GetName	Mengambil nama properti.
CMFCPropertyGridProperty::GetNameTooltip	Dipanggil oleh kerangka kerja untuk menampilkan nama properti dalam tipsalat.
CMFCPropertyGridProperty::GetOption	Mengambil teks opsi yang ditentukan oleh indeks.
CMFCPropertyGridProperty::GetOptionCount	Mengambil jumlah opsi milik properti.
CMFCPropertyGridProperty::GetOriginalValue	Mengambil nilai awal properti saat ini.
CMFCPropertyGridProperty::GetParent	Mengambil penunjuk ke properti induk.
CMFCPropertyGridProperty::GetRect	Mengambil persegi panjang pembatas properti.
CMFCPropertyGridProperty::GetSubItem	Mengambil subproperti yang diidentifikasi oleh indeks berbasis nol.
CMFCPropertyGridProperty::GetSubItemsCount	Mengambil jumlah subitem.
CMFCPropertyGridProperty::GetThisClass	Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke CRuntimeClass objek yang terkait dengan jenis kelas ini.
CMFCPropertyGridProperty::GetValue	Mengambil nilai properti.
CMFCPropertyGridProperty::GetValueTooltip	Dipanggil oleh kerangka kerja untuk mengambil representasi teks dari nilai properti yang kemudian ditampilkan dalam tipsalat.
CMFCPropertyGridProperty::HitTest	Menunjuk ke objek properti yang sesuai dengan item daftar properti yang sesuai dengan titik.
CMFCPropertyGridProperty::IsAllowEdit	Menunjukkan apakah properti dapat diedit.
CMFCPropertyGridProperty::IsEnabled	Menunjukkan apakah properti diaktifkan atau dinonaktifkan.
CMFCPropertyGridProperty::IsExpanded	Menunjukkan apakah properti diperluas atau diciutkan.
CMFCPropertyGridProperty::IsGroup	Menunjukkan apakah properti saat ini mewakili grup.
CMFCPropertyGridProperty::IsInPlaceEditing	Menunjukkan apakah properti saat ini dapat diedit.
CMFCPropertyGridProperty::IsModified	Menunjukkan apakah properti saat ini dimodifikasi.
CMFCPropertyGridProperty::IsParentExpanded	Menunjukkan apakah induk properti saat ini diperluas.
CMFCPropertyGridProperty::IsSelected	Menunjukkan apakah properti saat ini dipilih.
CMFCPropertyGridProperty::IsVisible	Menunjukkan apakah properti saat ini terlihat.
CMFCPropertyGridProperty::OnClickButton	Dipanggil oleh kerangka kerja saat pengguna memilih tombol yang terkandung dalam properti.
CMFCPropertyGridProperty::OnClickName	Dipanggil oleh kontrol daftar properti induk saat pengguna memilih bidang nama properti.
CMFCPropertyGridProperty::OnClickValue	Dipanggil oleh kontrol daftar properti induk saat pengguna memilih bidang nilai properti.
CMFCPropertyGridProperty::OnCloseCombo	Dipanggil oleh kerangka kerja saat kotak kombo yang terkandung dalam properti ditutup.
CMFCPropertyGridProperty::OnDblClk	Dipanggil oleh kerangka kerja saat pengguna mengklik dua kali properti.
CMFCPropertyGridProperty::OnDrawButton	Dipanggil oleh kerangka kerja untuk menggambar tombol yang terkandung dalam properti.
CMFCPropertyGridProperty::OnDrawDescription	Dipanggil oleh kerangka kerja untuk menampilkan deskripsi properti.
CMFCPropertyGridProperty::OnDrawExpandBox	Dipanggil oleh kerangka kerja untuk menggambar kontrol kotak perluas di dekat properti yang berisi subproperti.
CMFCPropertyGridProperty::OnDrawName	Dipanggil oleh kerangka kerja untuk menampilkan nama properti.
CMFCPropertyGridProperty::OnDrawValue	Dipanggil oleh kerangka kerja untuk menampilkan nilai properti.
CMFCPropertyGridProperty::OnEdit	Dipanggil oleh kerangka kerja saat pengguna akan memodifikasi nilai properti.
CMFCPropertyGridProperty::OnEndEdit	Dipanggil oleh kerangka kerja ketika pengguna selesai memodifikasi nilai properti.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName	Dipanggil oleh kerangka kerja saat pengguna memilih tombol kanan mouse di area nama properti.
CMFCPropertyGridProperty::OnRClickValue	Dipanggil oleh kerangka kerja saat pengguna memilih tombol kanan mouse di area nilai properti.
CMFCPropertyGridProperty::OnSelectCombo	Dipanggil oleh kerangka kerja saat pengguna memilih item dari kotak kombo yang dapat diedit.
CMFCPropertyGridProperty::OnSetCursor	Dipanggil oleh kerangka kerja saat penunjuk mouse berpindah ke item properti.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue	Dipanggil oleh kerangka kerja ketika nilai properti yang dapat diedit telah berubah.
CMFCPropertyGridProperty::PushChar	Dipanggil dari kontrol daftar properti saat properti dipilih dan pengguna memasukkan karakter baru.
CMFCPropertyGridProperty::Redraw	Menguras ulang properti.
CMFCPropertyGridProperty::RemoveAllOptions	Menghapus semua opsi (item) dari properti.
CMFCPropertyGridProperty::RemoveSubItem	Menghapus subitem yang ditentukan.
CMFCPropertyGridProperty::ResetOriginalValue	Memulihkan nilai asli properti yang diedit.
CMFCPropertyGridProperty::SetData	Mengaitkan nilai DWORD dengan properti.
CMFCPropertyGridProperty::SetDescription	Menentukan teks yang menjelaskan properti saat ini.
CMFCPropertyGridProperty::SetName	Mengatur nama properti.
CMFCPropertyGridProperty::SetOriginalValue	Mengatur nilai asli properti yang dapat diedit.
CMFCPropertyGridProperty::SetValue	Mengatur nilai properti kisi properti.
CMFCPropertyGridProperty::Show	Memperlihatkan atau menyembunyikan properti.

Metode yang Dilindungi

Nama	Deskripsi
CMFCPropertyGridProperty::CreateCombo	Dipanggil oleh kerangka kerja untuk menambahkan kotak kombo ke properti.
CMFCPropertyGridProperty::HasButton	Menunjukkan apakah properti berisi tombol.
CMFCPropertyGridProperty::Init	Dipanggil oleh kerangka kerja untuk menginisialisasi objek properti.
CMFCPropertyGridProperty::IsSubItem	Menunjukkan apakah properti yang ditentukan adalah subitem dari properti saat ini.
CMFCPropertyGridProperty::IsValueChanged	Menunjukkan apakah nilai properti saat ini telah berubah.
CMFCPropertyGridProperty::OnCtlColor	Dipanggil oleh kerangka kerja ketika harus mengambil kuas untuk mengisi warna latar belakang properti.
CMFCPropertyGridProperty::OnDestroyWindow	Dipanggil oleh kerangka kerja saat properti dihancurkan atau saat pengeditan selesai.
CMFCPropertyGridProperty::OnKillFocus	Dipanggil oleh kerangka kerja ketika properti kehilangan fokus input.

Anggota Data

Nama	Deskripsi
CMFCPropertyGridProperty::m_strFormatDouble	Format string untuk nilai jenis ganda.
CMFCPropertyGridProperty::m_strFormatFloat	Format string untuk nilai jenis float.
CMFCPropertyGridProperty::m_strFormatLong	Format string untuk nilai jenis panjang.
CMFCPropertyGridProperty::m_strFormatShort	Format string untuk nilai jenis pendek.

Keterangan

CMFCPropertyGridProperty Gunakan objek untuk mewakili properti, yang kemudian Anda tambahkan ke kontrol daftar properti. Untuk informasi selengkapnya, lihat CMFCPropertyGridCtrl Kelas.

Objek properti dapat mewakili jenis data seperti string, tanggal, dan nilai Boolean atau bilangan bulat. Ini dapat berisi properti anak, atau dapat berisi kontrol seperti kotak kombo atau kontrol tombol.

Contoh

Contoh berikut menunjukkan cara membuat CMFCPropertyGridProperty objek. Contoh ini juga menunjukkan cara menggunakan berbagai metode di CMFCPropertyGridProperty kelas untuk menambahkan opsi, menambahkan subitem, mengaktifkan properti, dan menampilkan properti. Contoh ini adalah bagian dari sampel Kontrol Baru.

CMFCPropertyGridProperty *pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

// construct a COleVariant object.
COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook,
                                                 _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

CMFCPropertyGridProperty *pProp = new CMFCPropertyGridProperty(_T("Border"),
                                                               _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
pProp->AddOption(_T("None"));
pProp->AddOption(_T("Thin"));
pProp->AddOption(_T("Resizable"));
pProp->AddOption(_T("Dialog Frame"));
pProp->AllowEdit(FALSE);

pGroup1->AddSubItem(pProp);
pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
pGroup1->AdjustButtonRect();
pGroup1->AllowEdit();
pGroup1->Enable();
pGroup1->Show();
pGroup1->Redraw();

Hierarki Warisan

CObject

CMFCPropertyGridProperty

Persyaratan

Header:afxpropertygridctrl.h

CMFCPropertyGridProperty::AddOption

Menambahkan item daftar baru ke kontrol daftar properti.

BOOL AddOption(
    LPCTSTR lpszOption,
    BOOL bInsertUnique=TRUE);

Parameter

lpszOption
[di] Item daftar (opsi) untuk ditambahkan.

bInsertUnique
[di] TRUE untuk menambahkan item daftar hanya jika belum ada; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

TRUE, yang berarti bahwa item daftar ditambahkan. Jika tidak, FALSE, yang berarti bahwa item daftar tidak ditambahkan karena bInsertUnique parameter adalah TRUE dan item daftar yang ditentukan oleh lpszOption parameter sudah ada.

CMFCPropertyGridProperty::AddSubItem

Menambahkan item anak ke properti.

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

Parameter

pProp
[di] Penunjuk ke properti untuk ditambahkan.

Tampilkan Nilai

TRUE jika properti yang ditentukan berhasil ditambahkan sebagai properti anak. FALSE jika properti tidak ditambahkan karena sudah terjadi di properti induk.

Keterangan

Gunakan metode ini untuk membuat daftar hierarkis properti induk dan anak. Setelah properti anak ditambahkan, properti induk secara otomatis menampilkan kontrol kotak perluas yang ditunjuk oleh tanda plus (+). Saat pengguna memilih tanda plus, properti induk memperluas dan menampilkan item properti turunan apa pun.

CMFCPropertyGridProperty::AdjustButtonRect

Dipanggil oleh kontrol daftar properti induk untuk memberi tahu properti untuk mengubah ukuran persegi panjang pembatas tombol yang disematkan.

virtual void AdjustButtonRect();

Keterangan

Secara default, metode ini:

• Menyesuaikan lebar tombol yang sama dengan tinggi tombol ditambah tiga piksel.
• Memindahkan persegi panjang pembatas tombol ke tepi kanan properti.
• Menggeser tombol 1 piksel di bawah tepi atas properti.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Mengambil batas kotak teks dan kontrol tombol putar opsional yang digunakan untuk mengatur nilai properti.

virtual void AdjustInPlaceEditRect(
    CRect& rectEdit,
    CRect& rectSpin);

Parameter

rectEdit
[out] Saat metode ini kembali, persegi panjang yang menentukan batas kotak teks untuk nilai properti.

rectSpin
[out] Ketika metode ini kembali, persegi panjang yang menentukan batas kontrol tombol putar untuk nilai properti. Atau, jika properti tidak mendukung tombol putar, persegi panjang kosong.

Keterangan

Area nilai properti terdiri dari kotak teks dan mungkin tombol opsi, seperti kontrol tombol putar. Metode ini menghitung dimensi kotak teks dan tombol opsi lalu mengembalikan nilai tersebut dalam parameter yang ditentukan.

CMFCPropertyGridProperty::AllowEdit

Membuat properti dapat diedit atau baca-saja.

void AllowEdit(BOOL bAllow=TRUE);

Parameter

bAllow
[di] TRUE untuk membuat properti dapat diedit; FALSE untuk membuat properti baca-saja. Nilai defaultnya adalah TRUE.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

Membuat CMFCPropertyGridProperty objek.

CMFCPropertyGridProperty(
    const CString& strGroupName,
    DWORD_PTR dwData=0,
    BOOL bIsValueList=FALSE);

CMFCPropertyGridProperty(
    const CString& strName,
    const _variant_t& varValue,
    LPCTSTR lpszDescr=NULL,
    DWORD_PTR dwData=0,
    LPCTSTR lpszEditMask=NULL,
    LPCTSTR lpszEditTemplate=NULL,
    LPCTSTR lpszValidChars=NULL);

Parameter

strGroupName
[di] Nama grup. Grup adalah kumpulan properti terkait dalam kontrol kisi properti. Jika kontrol ditampilkan secara hierarkis, nama grup ditampilkan sebagai judul kategori di baris di atas grup.

dwData
[di] Data khusus aplikasi, seperti bilangan bulat atau penunjuk ke data lain yang terkait dengan properti . Nilai default adalah 0.

strName
[in] Nama properti.

varValue
[di] Nilai properti.

lpszDescr
[di] Deskripsi properti. Nilai defaultnya adalah NULL.

lpszEditMask
[di] Edit masker, jika properti adalah kontrol edit bertopeng. Nilai defaultnya adalah NULL.

lpszEditTemplate
[di] Templat edit, jika properti adalah kontrol edit bertopeng. Nilai defaultnya adalah NULL.

lpszValidChars
[di] Daftar karakter yang valid, jika properti adalah kontrol edit bertopeng. Nilai defaultnya adalah NULL.

bIsValueList
[di] TRUE jika properti mewakili daftar nilai; FALSE jika properti mewakili satu nilai. Nilai defaultnya adalah FALSE.

CMFCPropertyGridProperty::CreateCombo

Dipanggil oleh kerangka kerja untuk menambahkan kotak kombo ke properti.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    CRect rect);

Parameter

pWndParent
[di] Penunjuk ke jendela induk kotak kombo.

rect
[di] Persegi panjang pembatas kotak kombo.

Tampilkan Nilai

Penunjuk ke objek baru CComboBox .

CMFCPropertyGridProperty::CreateInPlaceEdit

Dipanggil oleh kerangka kerja untuk membuat kontrol yang dapat diedit untuk properti.

virtual CWnd* CreateInPlaceEdit(
    CRect rectEdit,
    BOOL& bDefaultFormat);

Parameter

rectEdit
[di] Persegi panjang pembatas kontrol yang dapat diedit.

bDefaultFormat
[di] TRUE untuk menggunakan format properti default untuk mengatur teks kontrol yang dapat diedit; jika tidak, FALSE.

Tampilkan Nilai

Penunjuk ke kontrol yang dapat diedit jika metode ini berhasil; jika tidak, NULL.

Keterangan

Metode ini menggunakan nilai varValueparameter , , lpszEditMasklpszEditTemplate, dan lpszValidChars yang ditentukan dalam CMFCPropertyGridProperty konstruktor kelas. Secara default, metode ini mendukung varValue jenis varian. Ini termasuk VT_BSTR, , VT_R4, VT_R8VT_UI1, VT_I2, VT_INT, VT_UINT, , VT_I4, VT_UI2, VT_UI4, dan VT_BOOL.

Metode ini membuat CMFCMaskedEdit kontrol jika satu atau beberapa lpszEditMaskparameter , , lpszEditTemplateatau lpszValidChars ditentukan; jika tidak, metode ini akan CEdit membuat kontrol.

CMFCPropertyGridProperty::CreateSpinControl

Dipanggil oleh kerangka kerja untuk membuat kontrol tombol putar yang dapat diedit.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

Parameter

rectSpin
[di] Persegi panjang yang menentukan tempat kontrol tombol putar yang dapat diedit dibuat.

Tampilkan Nilai

Penunjuk ke objek baru CMFCSpinButtonCtrl yang dilemparkan sebagai penunjuk ke CSpinButtonCtrl objek.

Keterangan

CMFCPropertyGridProperty::EnableSpinControl Panggil metode untuk menampilkan kontrol tombol putar yang dapat diedit di tepi kanan properti.

CMFCPropertyGridProperty::Enable

Mengaktifkan atau menonaktifkan properti.

void Enable(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan properti; FALSE untuk menonaktifkan properti. Properti yang dinonaktifkan tidak merespons mouse atau input keyboard. Nilai defaultnya adalah TRUE.

CMFCPropertyGridProperty::EnableSpinControl

Mengaktifkan atau menonaktifkan kontrol tombol putar yang digunakan untuk mengubah nilai properti.

void EnableSpinControl(
    BOOL bEnable=TRUE,
    int nMin=0,
    int nMax=0);

Parameter

bEnable
[di] TRUE untuk mengaktifkan kontrol tombol putar; FALSE untuk menonaktifkan kontrol tombol putar. Nilai defaultnya adalah TRUE.

nMin
[di] Nilai minimum kontrol tombol putar. Nilai default adalah 0.

nMax
[di] Nilai maksimum kontrol tombol putar. Nilai default adalah 0.

Keterangan

Kerangka kerja secara otomatis membuat kontrol tombol putar saat properti akan diedit.

Jenis properti, yang ditentukan oleh varValue parameter CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktor, harus merupakan jenis varian yang didukung. Jika tidak, metode ini menegaskan dalam mode debug. Jenis yang didukung meliputi VT_INT, , VT_UINTVT_I2, VT_I4, VT_UI2, dan VT_UI4.

CMFCPropertyGridProperty::Expand

Memperluas atau menciutkan properti yang berisi subproperti.

void Expand(BOOL bExpand=TRUE);

Parameter

bExpand
[di] TRUE untuk memperluas properti; FALSE untuk menciutkan properti. Nilai defaultnya adalah TRUE.

CMFCPropertyGridProperty::FormatProperty

Memformat representasi teks dari nilai properti.

virtual CString FormatProperty();

Tampilkan Nilai

Representasi teks dari nilai properti.

Keterangan

Metode ini dipanggil oleh kerangka kerja sebelum nilai properti ditampilkan.

CMFCPropertyGridProperty::GetData

Mengambil DWORD nilai yang terkait dengan properti.

DWORD_PTR GetData() const;

Tampilkan Nilai

Nilai DWORD.

Keterangan

Data yang dikembalikan adalah nilai khusus aplikasi, seperti angka atau penunjuk ke data lain. Tentukan nilai data saat Anda membuat properti atau saat Anda memanggil CMFCPropertyGridProperty::SetData metode .

CMFCPropertyGridProperty::GetDescription

Mengambil deskripsi properti.

const CString& GetDescription() const;

Tampilkan Nilai

String teks yang berisi deskripsi properti.

Keterangan

Kontrol daftar properti juga menggunakan metode ini untuk menampilkan deskripsi properti.

CMFCPropertyGridProperty::GetExpandedSubItems

Mengambil jumlah subitem yang diperluas.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

Parameter

bIncludeHidden
[di] TRUE untuk menyertakan subitem tersembunyi dalam hitungan; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

Jumlah subitem yang diperluas.

CMFCPropertyGridProperty::GetHierarchyLevel

Mengambil indeks berbasis nol dari tingkat hierarki properti.

int GetHierarchyLevel() const;

Tampilkan Nilai

Tingkat hierarki properti.

CMFCPropertyGridProperty::GetName

Mengambil nama properti.

LPCTSTR GetName() const;

Tampilkan Nilai

Penunjuk ke string yang berisi nama properti.

CMFCPropertyGridProperty::GetNameTooltip

Dipanggil oleh kerangka kerja untuk menampilkan nama properti dalam tipsalat.

virtual CString GetNameTooltip();

Tampilkan Nilai

String yang berisi nama properti. Secara default, nilai yang dikembalikan adalah string kosong.

CMFCPropertyGridProperty::GetOption

Mengambil teks opsi yang ditentukan oleh indeks.

LPCTSTR GetOption(int nIndex) const;

Parameter

nIndex
Indeks berbasis nol dari item daftar properti (opsi) untuk diambil.

Tampilkan Nilai

Penunjuk ke string yang berisi teks opsi.

CMFCPropertyGridProperty::GetOptionCount

Mengambil jumlah opsi milik properti.

int GetOptionCount() const;

Tampilkan Nilai

Jumlah item daftar properti (opsi) yang terkandung dalam kontrol properti.

Keterangan

CMFCPropertyGridProperty::AddOption Panggil metode untuk menambahkan item ke daftar properti. CMFCPropertyGridProperty::RemoveAllOptions Panggil metode untuk menghapus semua item.

CMFCPropertyGridProperty::GetOriginalValue

Mengambil nilai awal properti saat ini.

const COleVariant& GetOriginalValue() const;

Tampilkan Nilai

Nilai asli properti saat ini.

Keterangan

Gunakan metode ini untuk mengurungkan efek operasi edit yang mengubah nilai properti saat ini.

Nilai asli properti saat ini diatur oleh CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktor, dimodifikasi oleh CMFCPropertyGridProperty::SetOriginalValue metode , dan diatur ulang dengan CMFCPropertyGridProperty::ResetOriginalValue metode .

CMFCPropertyGridProperty::GetParent

Mengambil penunjuk ke properti induk.

CMFCPropertyGridProperty* GetParent() const;

Tampilkan Nilai

Penunjuk ke objek properti induk, atau NULL untuk properti tingkat atas.

CMFCPropertyGridProperty::GetRect

Mengambil persegi panjang pembatas properti.

CRect GetRect() const;

Tampilkan Nilai

Objek CRect yang menjelaskan persegi panjang pembatas.

CMFCPropertyGridProperty::GetSubItem

Mengambil subproperti yang diidentifikasi oleh indeks berbasis nol.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

Parameter

nIndex
[di] Indeks berbasis nol properti yang akan diambil. Parameter ini tidak valid jika kurang dari nol atau lebih besar dari atau sama dengan jumlah subproperti.

Tampilkan Nilai

Penunjuk ke objek properti yang merupakan item turunan dari properti ini.

-atau-

Dalam mode ritel, NULL jika nIndex parameter tidak valid. Dalam mode debug, metode ini menegaskan.

CMFCPropertyGridProperty::GetSubItemsCount

Mengambil jumlah subitem.

int GetSubItemsCount() const;

Tampilkan Nilai

Jumlah item anak.

CMFCPropertyGridProperty::GetValue

Mengambil nilai properti.

virtual const _variant_t& GetValue() const;

Tampilkan Nilai

Varian yang berisi nilai properti.

CMFCPropertyGridProperty::GetValueTooltip

Dipanggil oleh kerangka kerja untuk mengambil representasi teks dari nilai properti yang kemudian ditampilkan dalam tipsalat.

virtual CString GetValueTooltip();

Tampilkan Nilai

Objek CString yang berisi representasi tekstual dari nilai properti. Secara default, nilai ini adalah string kosong.

CMFCPropertyGridProperty::HasButton

Menunjukkan apakah properti berisi tombol.

virtual BOOL HasButton() const;

Tampilkan Nilai

TRUE jika properti berisi tombol (atau daftar properti); jika tidak, FALSE.

CMFCPropertyGridProperty::HitTest

Menunjuk ke objek properti yang sesuai dengan item daftar properti yang sesuai dengan titik.

CMFCPropertyGridProperty* HitTest(
    CPoint point,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL);

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

Parameter

point
[di] Titik untuk menguji, dalam koordinat klien. Parameter ini biasanya merupakan lokasi penunjuk mouse saat ini.

pt
[di] Titik untuk menguji, dalam koordinat klien.

pnArea
[out] Ketika metode ini kembali, menunjukkan area yang berisi titik yang ditentukan. Untuk informasi selengkapnya, lihat Keterangan. Nilai defaultnya adalah NULL.

bPropsOnly
[di] TRUE untuk menguji area apa pun dalam kontrol properti; FALSE untuk menguji hanya area deskripsi. Nilai defaultnya adalah FALSE.

Tampilkan Nilai

Penunjuk ke objek properti atau NULL.

Keterangan

Secara default, metode ini menguji subitem properti jika titik yang ditentukan tidak ditemukan dalam item properti apa pun.

Tabel berikut mencantumkan nilai yang dapat dikembalikan ke pnArea parameter .

Area	Deskripsi
ClickArea::ClickExpandBox	Kontrol kotak perluas, yang ditunjuk oleh tanda plus (+).
ClickArea::ClickName	Nama properti.
ClickArea::ClickValue	Nilai properti.

CMFCPropertyGridProperty::Init

Dipanggil oleh kerangka kerja untuk menginisialisasi objek properti.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

Menunjukkan apakah properti dapat diedit.

BOOL IsAllowEdit() const;

Tampilkan Nilai

TRUE jika properti dapat diedit; jika tidak FALSE.

CMFCPropertyGridProperty::IsEnabled

Menunjukkan apakah properti diaktifkan atau dinonaktifkan.

BOOL IsEnabled() const;

Tampilkan Nilai

TRUE jika properti diaktifkan; FALSE jika properti dinonaktifkan.

Keterangan

Memberi tahu apakah properti diaktifkan atau dinonaktifkan.

CMFCPropertyGridProperty::IsExpanded

Menunjukkan apakah properti diperluas atau diciutkan.

BOOL IsExpanded() const;

Tampilkan Nilai

TRUE jika properti diperluas; FALSE jika properti diciutkan.

CMFCPropertyGridProperty::IsGroup

Menunjukkan apakah properti saat ini mewakili grup.

BOOL IsGroup() const;

Tampilkan Nilai

TRUE jika objek properti saat ini mewakili grup; FALSE jika properti mewakili nilai.

Keterangan

Grup adalah kumpulan properti terkait dalam kontrol kisi properti. Jika kontrol ditampilkan secara hierarkis, nama grup ditampilkan sebagai judul kategori di baris di atas grup.

CMFCPropertyGridProperty::IsInPlaceEditing

Menunjukkan apakah properti saat ini dapat diedit.

BOOL IsInPlaceEditing() const;

Tampilkan Nilai

TRUE jika properti saat ini dapat diedit; jika tidak, FALSE.

CMFCPropertyGridProperty::IsModified

Menunjukkan apakah properti saat ini dimodifikasi.

BOOL IsModified() const;

Tampilkan Nilai

TRUE jika properti dimodifikasi; jika tidak, FALSE.

CMFCPropertyGridProperty::IsParentExpanded

Menunjukkan apakah induk properti saat ini diperluas.

BOOL IsParentExpanded() const;

Tampilkan Nilai

TRUE jika semua orang tua properti saat ini diperluas; FALSE jika properti induk diciutkan.

CMFCPropertyGridProperty::IsSelected

Menunjukkan apakah properti saat ini dipilih.

virtual BOOL IsSelected() const;

Tampilkan Nilai

TRUE jika properti saat ini dipilih; jika tidak, FALSE.

CMFCPropertyGridProperty::IsSubItem

Menunjukkan apakah properti yang ditentukan adalah subitem dari properti saat ini.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

Parameter

pProp
[di] Penunjuk ke properti.

Tampilkan Nilai

TRUE jika properti yang ditentukan adalah subitem dari properti saat ini; jika tidak, FALSE.

CMFCPropertyGridProperty::IsValueChanged

Menunjukkan apakah nilai properti saat ini telah berubah.

virtual BOOL IsValueChanged() const;

Tampilkan Nilai

TRUE jika nilai properti saat ini telah berubah; jika tidak, FALSE.

CMFCPropertyGridProperty::IsVisible

Menunjukkan apakah properti saat ini terlihat.

BOOL IsVisible() const;

Tampilkan Nilai

TRUE jika properti saat ini terlihat; Sebaliknya; FALSE.

CMFCPropertyGridProperty::m_strFormatDouble

Menyimpan string format untuk nilai jenis ganda.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

Menyimpan string format untuk nilai jenis float.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

Menyimpan string format untuk nilai jenis panjang.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

Menyimpan string format untuk nilai jenis pendek.

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

Dipanggil oleh kerangka kerja saat pengguna memilih tombol yang terkandung dalam properti.

virtual void OnClickButton(CPoint point);

Parameter

point
[di] Titik, dalam koordinat klien.

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnClickName

Dipanggil oleh kontrol daftar properti induk saat pengguna memilih bidang nama properti.

virtual void OnClickName(CPoint C);

Parameter

C
[di] Titik, dalam koordinat klien.

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnClickValue

Dipanggil oleh kontrol daftar properti induk saat pengguna memilih bidang nilai properti.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

Parameter

uiMsg
[di] Pesan mouse.

point
[di] Titik, dalam koordinat klien.

Tampilkan Nilai

TRUE jika pesan mouse yang ditentukan diproses oleh metode ini; jika tidak, FALSE.

Keterangan

Secara default, metode ini mengembalikan FALSE jika properti saat ini tidak dapat diedit. Jika tidak, kontrol edit atau putar yang terkait dengan properti ini memproses pesan mouse yang ditentukan, lalu metode ini mengembalikan TRUE.

CMFCPropertyGridProperty::OnCloseCombo

Dipanggil oleh kerangka kerja saat kotak kombo yang terkandung dalam properti ditutup.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

Dipanggil oleh kerangka kerja ketika harus mengambil kuas untuk mengisi warna latar belakang properti.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

nCtlColor
[di] (Parameter ini tidak digunakan.)

Tampilkan Nilai

Handel ke kuas jika metode ini berhasil; jika tidak, NULL.

CMFCPropertyGridProperty::OnDblClk

Dipanggil oleh kerangka kerja saat pengguna mengklik dua kali properti.

virtual BOOL OnDblClk(CPoint point);

Parameter

point
[di] Titik, dalam koordinat klien.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Secara default, metode ini memilih item properti berikutnya dalam kontrol daftar properti.

CMFCPropertyGridProperty::OnDestroyWindow

Dipanggil oleh kerangka kerja saat properti dihancurkan atau saat pengeditan selesai.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

Dipanggil oleh kerangka kerja untuk menggambar tombol yang terkandung dalam properti.

virtual void OnDrawButton(
    CDC* pDC,
    CRect rectButton);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rectButton
[di] Persegi panjang pembatas yang menentukan tempat untuk menggambar tombol.

CMFCPropertyGridProperty::OnDrawDescription

Dipanggil oleh kerangka kerja untuk menggambar deskripsi properti.

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang pembatas yang menentukan tempat untuk menggambar deskripsi properti.

Keterangan

Secara default, metode ini menggambar nama dan deskripsi properti dalam font yang digunakan oleh kontrol daftar properti induk. Deskripsi properti digambar dalam gaya reguler dan nama properti digambar dengan gaya tebal.

CMFCPropertyGridProperty::OnDrawExpandBox

Dipanggil oleh kerangka kerja untuk menggambar kontrol kotak perluas di dekat properti yang berisi subproperti.

virtual void OnDrawExpandBox(
    CDC* pDC,
    CRect rectExpand);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rectExpand
[di] Persegi panjang pembatas yang menentukan tempat untuk menggambar kontrol kotak perluas.

Keterangan

Pilih kontrol kotak perluas untuk memperluas atau menciutkan daftar subproperti. Kontrol kotak perluas ditunjuk oleh persegi yang berisi tanda plus (+) atau minus (-). Tanda plus menunjukkan bahwa properti dapat diperluas untuk menampilkan daftar subproperti. Tanda minus menunjukkan bahwa daftar dapat diciutkan untuk hanya menampilkan properti .

CMFCPropertyGridProperty::OnDrawName

Dipanggil oleh kerangka kerja untuk menampilkan nama properti.

virtual void OnDrawName(
    CDC* pDC,
    CRect rect);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang pembatas yang menentukan tempat untuk menggambar nama properti.

CMFCPropertyGridProperty::OnDrawValue

Dipanggil oleh kerangka kerja untuk menampilkan nilai properti.

virtual void OnDrawValue(
    CDC* pDC,
    CRect rect);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi berbatas yang menentukan tempat untuk menggambar nilai properti.

CMFCPropertyGridProperty::OnEdit

Dipanggil oleh kerangka kerja saat pengguna akan memodifikasi nilai properti.

virtual BOOL OnEdit(LPPOINT lptClick);

Parameter

lptClick
[di] (Parameter ini tidak digunakan.) Pointer ke titik, dalam koordinat klien.

Tampilkan Nilai

TRUE jika operasi edit berhasil dimulai; jika tidak, FALSE.

Keterangan

Fungsi ini dipanggil oleh kerangka kerja ketika pengguna akan memodifikasi nilai properti. Secara default, metode ini memulai editor yang sesuai untuk kontrol kotak kombo atau kontrol putar.

CMFCPropertyGridProperty::OnEndEdit

Dipanggil oleh kerangka kerja ketika pengguna selesai memodifikasi nilai properti.

virtual BOOL OnEndEdit();

Tampilkan Nilai

Metode ini selalu mengembalikan TRUE.

Keterangan

Secara default, metode ini menghancurkan kontrol pengeditan saat ini lalu mengembalikan TRUE.

CMFCPropertyGridProperty::OnKillFocus

Dipanggil oleh kerangka kerja ketika properti kehilangan fokus input.

virtual BOOL OnKillFocus(CWnd*);

Parameter

CWnd
[di] (Tidak digunakan.) Penunjuk ke jendela.

Tampilkan Nilai

Metode ini selalu mengembalikan TRUE.

Keterangan

Secara default, metode ini tidak melakukan apa pun dan kemudian mengembalikan TRUE. Jika Anda mengambil alih metode ini, kembalikan TRUE jika kerangka kerja dapat mengakhiri operasi edit saat properti kehilangan fokus input.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

Parameter

[in] CMFCPropertyGridProperty*

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

Parameter

[in] CRect

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnRClickName

Dipanggil oleh kerangka kerja saat pengguna memilih tombol kanan mouse di area nama properti.

virtual void OnRClickName(CPoint C);

Parameter

C
[di] Titik, dalam koordinat klien.

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnRClickValue

Dipanggil oleh kerangka kerja saat pengguna memilih tombol kanan mouse di area nilai properti.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

Parameter

C
[di] Titik, dalam koordinat klien.

B
[di] Sebuah Boolean.

Keterangan

Secara default, metode ini tidak melakukan apa pun dan B parameter tidak memiliki tujuan yang telah ditentukan sebelumnya.

CMFCPropertyGridProperty::OnSelectCombo

Dipanggil oleh kerangka kerja saat pengguna memilih item dari kotak kombo yang dapat diedit.

virtual void OnSelectCombo();

Keterangan

Secara default, metode ini menggunakan teks item yang dipilih untuk memperbarui nilai properti.

CMFCPropertyGridProperty::OnSetCursor

Dipanggil oleh kerangka kerja saat penunjuk mouse berpindah ke item properti.

virtual BOOL OnSetCursor() const;

Tampilkan Nilai

TRUE jika properti saat ini adalah jenis varian atau daftar nilai, dan metode ini berhasil memuat kursor mouse titik penyisipan (I-beam) ; jika tidak, FALSE.

Keterangan

Metode ini mendukung jenis varian berikut: VT_INT, , VT_I2, VT_I4, VT_UINT, VT_UI1VT_UI2, , VT_UI4, VT_R4, VT_R8dan VT_BSTR.

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection(CMFCPropertyGridProperty*);

Parameter

[in] CMFCPropertyGridProperty*

Keterangan

Secara default, metode ini tidak melakukan apa pun.

CMFCPropertyGridProperty::OnUpdateValue

Dipanggil oleh kerangka kerja ketika nilai properti yang dapat diedit telah berubah.

virtual BOOL OnUpdateValue();

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

CMFCPropertyGridProperty::PushChar

Dipanggil dari kontrol daftar properti saat properti dipilih dan pengguna memasukkan karakter baru.

virtual BOOL PushChar(UINT nChar);

Parameter

nChar
[di] Karakter.

Tampilkan Nilai

TRUE jika operasi edit berlanjut; jika tidak, FALSE.

Keterangan

Metode ini mendukung properti yang merupakan daftar nilai atau salah satu jenis varian berikut: VT_INT, , , VT_I2VT_I4, VT_UINT, VT_UI1VT_UI2, , VT_UI4, VT_R4, , VT_R8dan VT_BSTR.

CMFCPropertyGridProperty::Redraw

Menguras ulang properti.

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

Menghapus semua opsi (item) dari properti.

void RemoveAllOptions();

Keterangan

Opsi juga dikenal sebagai item daftar kontrol daftar properti.

CMFCPropertyGridProperty::RemoveSubItem

Menghapus subitem yang ditentukan.

BOOL RemoveSubItem(
    CMFCPropertyGridProperty*& pProp,
    BOOL bDelete=TRUE);

Parameter

pProp
[di] Penunjuk ke subitem properti.

bDelete
[di] TRUE untuk menghapus objek properti yang ditentukan oleh pProp parameter; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

Keterangan

Tentukan FALSE untuk bDelete parameter jika Anda ingin memindahkan subitem yang ditentukan; yaitu, hapus subitem lalu tambahkan di tempat lain.

CMFCPropertyGridProperty::ResetOriginalValue

Memulihkan nilai asli properti yang diedit.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

DWORD Mengaitkan nilai dengan properti.

void SetData(DWORD_PTR dwData);

Parameter

dwData
[di] Nilai 32-bit khusus aplikasi, seperti bilangan bulat atau penunjuk ke data lain.

Keterangan

CMFCPropertyGridProperty::GetData Gunakan metode untuk mengambil DWORD nilai. CMFCPropertyGridCtrl::FindItemByData Gunakan metode untuk menemukan item daftar properti yang terkait dengan nilai yang ditentukanDWORD.

CMFCPropertyGridProperty::SetDescription

Menentukan teks yang menjelaskan properti saat ini.

void SetDescription(const CString& strDescr);

Parameter

strDescr
[di] Teks yang menjelaskan properti saat ini.

CMFCPropertyGridProperty::SetName

Mengatur nama properti.

void SetName(
    LPCTSTR lpszName,
    BOOL bRedraw=TRUE);

Parameter

lpszName
[in] Nama properti.

bRedraw
[di] TRUE untuk segera menggambar ulang properti; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

CMFCPropertyGridProperty::SetOriginalValue

Mengatur nilai asli properti yang dapat diedit.

virtual void SetOriginalValue(const COleVariant& varValue);

Parameter

varValue
[di] Nilai.

Keterangan

CMFCPropertyGridProperty::ResetOriginalValue Gunakan metode untuk mengatur ulang nilai asli properti yang diedit.

CMFCPropertyGridProperty::SetValue

Mengatur nilai properti kisi properti.

virtual void SetValue(const _variant_t& varValue);

Parameter

varValue
[di] Referensi ke nilai untuk mengatur properti.

Contoh: SetValue

void SetPropBarValue(UINT propId, const DWORD& barPropDwordValue)
{
  auto property = propertiesGridCtrlList.FindItemByData(propId);
  if (property != nullptr)
  {
    property->SetValue(static_cast<_variant_t >(barPropDwordValue == 1)); // set value to true or false depending on dword value
  }
}

CMFCPropertyGridProperty::Show

Memperlihatkan atau menyembunyikan properti.

void Show(
    BOOL bShow=TRUE,
    BOOL bAdjustLayout=TRUE);

Parameter

bShow
[di] TRUE untuk menampilkan properti saat ini dan subitemnya; FALSE untuk menyembunyikan properti saat ini dan subitemnya. Nilai defaultnya adalah TRUE.

bAdjustLayout
[di] TRUE untuk menghitung ulang cara menggambar label dan nilai properti lalu menggambar properti; FALSE untuk menggunakan perhitungan yang ada untuk menggambar properti. Nilai defaultnya adalah TRUE.

Lihat juga

Bagan Hierarki
Kelas
CMFCPropertyGridCtrl class