Kelas CMFCPropertyGridCtrl

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.

Mendukung kontrol kisi properti yang dapat diedit yang dapat menampilkan properti dalam urutan alfabet atau hierarkis.

Sintaks

class CMFCPropertyGridCtrl : public CWnd

Anggota

Konstruktor Publik

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

Metode Publik

Nama	Deskripsi
CMFCPropertyGridCtrl::accHitTest	Dipanggil oleh kerangka kerja untuk mengambil elemen turunan atau objek turunan pada titik tertentu di layar. (Mengambil alih CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Dipanggil oleh kerangka kerja untuk mengambil lokasi layar objek yang ditentukan saat ini. (Mengambil alih CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Dipanggil oleh kerangka kerja untuk mengubah pilihan atau memindahkan fokus keyboard dari objek yang ditentukan. (Mengambil alih CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Menambahkan properti baru ke kontrol kisi properti.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Menutup kotak dialog pemilihan warna.
CMFCPropertyGridCtrl::Create	Membuat kontrol kisi properti dan melampirkannya ke objek kontrol kisi properti.
CMFCPropertyGridCtrl::DeleteProperty	Menghapus properti yang ditentukan dari kontrol kisi properti.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Mengaktifkan atau menonaktifkan area deskripsi yang ditampilkan di bawah daftar properti.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Mengaktifkan atau menonaktifkan kontrol header di bagian atas kontrol kisi properti.
CMFCPropertyGridCtrl::EnsureVisible	Menggulir kontrol kisi properti dan memperluas item properti hingga properti yang ditentukan terlihat.
CMFCPropertyGridCtrl::ExpandAll	Memperluas atau menciutkan semua simpul kontrol kisi properti.
CMFCPropertyGridCtrl::FindItemByData	Mengambil properti yang terkait dengan nilai yang ditentukan DWORD pengguna.
CMFCPropertyGridCtrl::get_accChild	Dipanggil oleh kerangka kerja untuk mengambil alamat IDispatch antarmuka untuk anak yang ditentukan. (Mengambil alih CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Dipanggil oleh kerangka kerja untuk mengambil jumlah anak milik objek ini. (Mengambil alih CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Dipanggil oleh kerangka kerja untuk mengambil string yang menjelaskan tindakan default objek. (Mengambil alih CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Dipanggil oleh kerangka kerja untuk mengambil string yang menjelaskan tampilan visual objek yang ditentukan. (Mengambil alih CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Dipanggil oleh kerangka kerja untuk mengambil objek yang memiliki fokus keyboard. (Mengambil alih CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Dipanggil oleh kerangka kerja untuk mengambil string properti objek Help . (Mengambil alih CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Dipanggil oleh kerangka kerja untuk mengambil jalur lengkap file yang WinHelp terkait dengan objek yang ditentukan dan pengidentifikasi topik yang sesuai dalam file tersebut. (Mengambil alih CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Dipanggil oleh kerangka kerja untuk mengambil kunci pintasan atau kunci akses objek yang ditentukan. (Mengambil alih CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Dipanggil oleh kerangka kerja untuk mengambil nama objek yang ditentukan. (Mengambil alih CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Dipanggil oleh kerangka kerja untuk mengambil informasi yang menjelaskan peran objek yang ditentukan. (Mengambil alih CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Dipanggil oleh kerangka kerja untuk mengambil anak terpilih dari objek ini. (Mengambil alih CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Dipanggil oleh kerangka kerja untuk mengambil status objek yang ditentukan saat ini. (Mengambil alih CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Dipanggil oleh kerangka kerja untuk mengambil nilai objek yang ditentukan. (Mengambil alih CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Mengambil warna latar belakang kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::GetBoldFont	Mengambil font Windows dari teks dalam kontrol kisi properti saat ini dalam gaya tebal.
CMFCPropertyGridCtrl::GetCurSel	Mengambil properti yang saat ini dipilih.
CMFCPropertyGridCtrl::GetCustomColors	Mengambil warna kustom yang saat ini ditentukan untuk elemen kontrol kisi properti.
CMFCPropertyGridCtrl::GetDescriptionHeight	Mengambil tinggi area deskripsi yang terletak di bagian bawah kontrol kisi properti.
CMFCPropertyGridCtrl::GetDescriptionRows	Mengambil jumlah baris di area deskripsi kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::GetHeaderCtrl	Mengambil objek internal CMFCHeaderCtrl yang digunakan kerangka kerja untuk menampilkan kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::GetHeaderHeight	Mengambil tinggi header kontrol kisi properti.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Mengambil lebar kolom kiri kontrol kisi properti saat ini, yang berisi nama setiap properti.
CMFCPropertyGridCtrl::GetListRect	Mengambil persegi panjang pembatas kontrol kisi properti.
CMFCPropertyGridCtrl::GetProperty	Mengambil penunjuk ke objek properti yang sesuai dengan indeks item kontrol kisi properti yang ditentukan.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Mengambil lebar kolom saat ini yang berisi nilai properti.
CMFCPropertyGridCtrl::GetPropertyCount	Mengambil jumlah properti dalam kontrol kisi properti.
CMFCPropertyGridCtrl::GetRowHeight	Mengambil tinggi baris dalam kontrol kisi properti.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Mengambil penunjuk ke kontrol bilah gulir di kontrol kisi properti. (Mengambil alih CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Mengambil warna teks item properti dalam kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::GetThisClass	Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke CRuntimeClass objek yang terkait dengan jenis kelas ini.
CMFCPropertyGridCtrl::HitTest	Mengambil penunjuk ke objek properti yang sesuai dengan item kontrol kisi properti jika titik yang ditentukan ada dalam item. Metode ini juga menunjukkan area dalam kontrol kisi properti yang berisi titik .
CMFCPropertyGridCtrl::InitHeader	Menginisialisasi objek internal CMFCHeaderCtrl yang digunakan kerangka kerja untuk menampilkan kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::IsAlphabeticMode	Menunjukkan apakah kontrol kisi properti dalam mode alfabet.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Menunjukkan apakah area deskripsi kontrol kisi properti ditampilkan.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Menunjukkan apakah setiap nama grup properti ditampilkan di seluruh lebar kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::IsHeaderCtrl	Menunjukkan apakah kontrol header ditampilkan.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Menunjukkan bagaimana kontrol kisi properti menampilkan properti yang dimodifikasi.
CMFCPropertyGridCtrl::IsShowDragContext	Menunjukkan apakah kerangka kerja menggambar ulang kolom nama dan nilai kontrol kisi properti saat ini saat pengguna mengubah ukuran kolom.
CMFCPropertyGridCtrl::IsVSDotNetLook	Menunjukkan apakah tampilan kontrol kisi properti dalam gaya yang digunakan oleh VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Menentukan cara menampilkan properti yang dimodifikasi.
CMFCPropertyGridCtrl::PreTranslateMessage	Digunakan oleh kelas CWinApp untuk menerjemahkan pesan jendela sebelum dikirim ke TranslateMessage fungsi Windows dan DispatchMessage . (Mengambil alih CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Menghapus semua objek properti dari kontrol kisi properti.
CMFCPropertyGridCtrl::ResetOriginalValues	Memulihkan nilai asli semua properti.
CMFCPropertyGridCtrl::SetAlphabeticMode	Mengatur atau mengatur ulang mode alfabet.
CMFCPropertyGridCtrl::SetBoolLabels	Menentukan teks label Boolean.
CMFCPropertyGridCtrl::SetCurSel	Memilih properti dalam kontrol kisi properti.
CMFCPropertyGridCtrl::SetCustomColors	Menentukan warna kustom untuk berbagai elemen kontrol kisi properti.
CMFCPropertyGridCtrl::SetDescriptionRows	Menentukan jumlah baris yang akan ditampilkan di bagian deskripsi kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Menentukan apakah akan menampilkan lebar penuh nama kategori untuk sekelompok properti dalam kontrol kisi properti saat ini.
CMFCPropertyGridCtrl::SetListDelimiter	Menentukan karakter yang akan digunakan sebagai pemisah dalam daftar nilai properti.
CMFCPropertyGridCtrl::SetShowDragContext	Menentukan apakah kerangka kerja menggambar ulang kolom nama dan nilai kontrol kisi properti saat ini saat pengguna mengubah ukuran kolom.
CMFCPropertyGridCtrl::SetVSDotNetLook	Mengatur tampilan kontrol kisi properti ke gaya yang digunakan dalam VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Menyetel nilai warna properti warna yang saat ini dipilih.

Metode yang Dilindungi

Nama	Deskripsi
CMFCPropertyGridCtrl::AdjustLayout	Mengurai ulang kontrol kisi properti dan propertinya.
CMFCPropertyGridCtrl::CompareProps	Dipanggil oleh kontrol kisi properti untuk mengurutkan properti.
CMFCPropertyGridCtrl::EditItem	Dipanggil oleh kerangka kerja ketika pengguna mulai memodifikasi properti.
CMFCPropertyGridCtrl::EndEditItem	Dipanggil oleh kerangka kerja saat pengguna berhenti memodifikasi properti.
CMFCPropertyGridCtrl::Init	Dipanggil oleh kerangka kerja untuk menginisialisasi kontrol kisi properti.
CMFCPropertyGridCtrl::OnChangeSelection	Dipanggil oleh kerangka kerja ketika pilihan saat ini diubah.
CMFCPropertyGridCtrl::OnClickButton	Dipanggil oleh kerangka kerja saat tombol properti diklik.
CMFCPropertyGridCtrl::OnDrawBorder	Dipanggil oleh kerangka kerja untuk menggambar batas di sekitar kontrol kisi properti.
CMFCPropertyGridCtrl::OnDrawDescription	Dipanggil oleh kerangka kerja untuk menggambar area deskripsi dan menampilkan teks deskripsi.
CMFCPropertyGridCtrl::OnDrawList	Dipanggil oleh kerangka kerja untuk menampilkan daftar properti dalam kontrol kisi properti.
CMFCPropertyGridCtrl::OnDrawProperty	Dipanggil oleh kerangka kerja untuk menampilkan properti.
CMFCPropertyGridCtrl::OnPropertyChanged	Dipanggil oleh kerangka kerja saat nilai properti diubah.
CMFCPropertyGridCtrl::OnSelectCombo	Dipanggil oleh kerangka kerja saat properti yang berisi kontrol kotak kombo dipilih.
CMFCPropertyGridCtrl::ValidateItemData	Dipanggil oleh kerangka kerja untuk memvalidasi data properti.

Keterangan

Kelas CMFCPropertyGridCtrl menampilkan kontrol kisi properti yang berisi properti yang dapat diedit yang berasal dari CMFCPropertyGridProperty kelas . Setiap properti dapat mewakili jenis dan dapat berisi subitem. Kontrol kisi properti mendukung area yang dapat diubah ukurannya di bagian bawah yang dapat menampilkan deskripsi properti yang dipilih.

Untuk menggunakan kontrol kisi properti, buat CMFCPropertyGridCtrl objek lalu panggil CMFCPropertyGridCtrl::Create metode . CMFCPropertyGridCtrl::AddProperty Gunakan metode untuk menambahkan properti ke daftar.

Properti Pilihan

Alih-alih mewakili nilai, item properti dapat memulai kotak dialog yang memungkinkan pengguna memilih warna, file, atau font.

Tabel berikut ini mencantumkan empat jenis properti pilihan:

Kelas	Deskripsi
CMFCPropertyGridProperty Kelas	Properti tujuan umum yang digunakan untuk menentukan nilai string, Boolean, tanggal, dan sebagainya.
CMFCPropertyGridColorProperty Kelas	Properti yang digunakan untuk memilih nilai warna.
CMFCPropertyGridFileProperty Kelas	Properti yang digunakan untuk memilih file.
CMFCPropertyGridFontProperty Kelas	Properti yang digunakan untuk memilih font.

Ilustrasi

Ilustrasi berikut menggambarkan kontrol kisi properti yang menampilkan properti dengan dua cara. Ilustrasi pertama menampilkan properti secara hierarkis dan yang kedua menampilkan properti menurut abjad.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi objek kontrol kisi properti dengan menggunakan berbagai metode di CMFCPropertyGridCtrl kelas . Contoh menunjukkan cara mengaktifkan kontrol header, mengaktifkan area deskripsi, dan mengatur tampilan kontrol kisi properti. Contoh juga menunjukkan cara mengatur mode alfabet untuk kontrol di mana kontrol mengurutkan semua properti yang dikandungnya berdasarkan nama propertinya, dan cara mengatur warna kustom untuk berbagai elemen kontrol kisi properti. Contoh ini adalah bagian dari sampel Kontrol Baru.

CMFCPropertyGridCtrl m_wndPropList;

m_wndPropList.EnableHeaderCtrl();
m_wndPropList.EnableDescriptionArea();
m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
// BOOL m_bMarkChanged
m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
// BOOL m_bPropListCategorized
m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
// BOOL m_bShowDragContext
m_wndPropList.SetShowDragContext(m_bShowDragContext);

// BOOL m_bMarkSortedColumn
m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);

// BOOL m_bPropListCustomColors
// set custom colors for various elements of the property grid control
if (m_bPropListCustomColors)
{
   m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
}
else
{
   COLORREF c = (COLORREF)-1;
   m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
}

m_wndPropList.RedrawWindow();

// restore original values of the properties
m_wndPropList.ResetOriginalValues();

Hierarki Warisan

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Persyaratan

Header :afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parameter

[di] flagsSelect
[di] varChild

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::AddProperty

Menambahkan properti baru ke kontrol kisi properti.

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parameter

pProp
[di] Penunjuk ke properti.

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

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

Tampilkan Nilai

Jika metode ini berhasil, indeks berbasis nol dari posisi dalam kontrol kisi properti tempat properti ditambahkan; jika tidak, -1.

Keterangan

Metode ini menambahkan penunjuk ke properti yang ditentukan ke akhir daftar properti dalam kontrol kisi properti. Jangan hancurkan properti atau izinkan mereka keluar dari cakupan sebelum kontrol kisi dihancurkan. Setelah selesai dengan kontrol kisi properti, panggil CMFCPropertyGridCtrl::RemoveAll untuk menghapus semua properti yang ditambahkan. Metode AddProperty gagal jika properti yang ditentukan telah ditambahkan ke daftar.

CMFCPropertyGridCtrl::AdjustLayout

Mengurai ulang kontrol kisi properti dan propertinya.

virtual void AdjustLayout();

Keterangan

Metode ini menghitung ulang cara menggambar seluruh kontrol kisi properti dan propertinya, termasuk gambar, font, dan kontrol.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parameter

[di] bShow

Keterangan

CMFCPropertyGridCtrl::CloseColorPopup

Menutup kotak dialog pemilihan warna.

virtual void CloseColorPopup();

Keterangan

Untuk informasi selengkapnya tentang kotak dialog pemilihan warna, lihat CMFCPropertyGridColorProperty Kelas.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Membuat CMFCPropertyGridCtrl objek.

CMFCPropertyGridCtrl();

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::CompareProps

Dipanggil oleh kontrol kisi properti untuk mengurutkan properti.

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

Parameter

pProp1
Penunjuk ke properti.

pProp2
Penunjuk ke properti.

Tampilkan Nilai

Tampilkan Nilai	Deskripsi
< 0	Nama pProp1 parameter kurang dari nama pProp2 parameter.
0	Nama pProp1 parameter sama dengan nama pProp2 parameter.
> 0	Nama pProp1 objek lebih besar dari nama pProp2 parameter.

Keterangan

Secara default, metode ini menggunakan CString::Compare metode untuk membandingkan CMFCPropertyGridProperty::m_strName anggota parameter yang ditentukan.

CMFCPropertyGridCtrl::Create

Membuat kontrol kisi properti dan melampirkannya ke objek kontrol kisi properti.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
[di] Kombinasi bitwise "atau" (|) dari gaya jendela.

rect
[di] Persegi panjang pembatas yang menentukan ukuran dan posisi jendela, dalam koordinat klien .pParentWnd

pParentWnd
[di] Penunjuk ke jendela induk. Tidak boleh NULL.

nID
[di] ID jendela anak.

Tampilkan Nilai

TRUE jika jendela berhasil dibuat; jika tidak, FALSE.

Keterangan

Untuk membuat kontrol kisi properti, pertama-tama panggil CMFCPropertyGridCtrl::CMFCPropertyGridCtrl untuk membuat objek kisi properti. Kemudian hubungi CMFCPropertyGridCtrl::Create.

Contoh

Contoh berikut menunjukkan cara menggunakan Create metode di CMFCPropertyGridCtrl kelas. Contoh ini adalah bagian dari sampel Kontrol Baru.

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Menghapus properti yang ditentukan dari kontrol kisi properti.

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parameter

pProp
[di] Penunjuk ke properti.

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

bAdjustLayout
[di] TRUE untuk menghitung ulang cara menggambar semua teks, gambar, dan item dalam kontrol kisi properti, lalu menggambar kontrol; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Gunakan metode ini untuk menghapus properti, dan sub-item apa pun, dari kontrol kisi properti.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::EditItem

Dipanggil oleh kerangka kerja ketika pengguna mulai memodifikasi properti.

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

Parameter

pProp
[di] Penunjuk ke properti.

lptClick
[di] Titik pada kontrol kisi properti yang diklik pengguna untuk memulai operasi edit. Intinya ada di koordinat klien kontrol. Nilai defaultnya adalah NULL.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak, FALSE.

Keterangan

CMFCPropertyGridCtrl::EnableDescriptionArea

Mengaktifkan atau menonaktifkan area deskripsi yang ditampilkan di bawah daftar properti dalam kontrol kisi properti.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan area deskripsi; FALSE untuk menonaktifkan area deskripsi. Nilai defaultnya adalah TRUE.

Keterangan

Area deskripsi ditampilkan di bagian bawah kontrol kisi properti. Secara default, area deskripsi dinonaktifkan dan tidak terlihat.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Mengaktifkan atau menonaktifkan kontrol header di bagian atas kontrol kisi properti.

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

Parameter

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

lpszLeftColumn
[di] Judul kolom kiri kontrol header. Nilai defaultnya adalah Property.

lpszRightColumn
[di] Judul kolom kanan kontrol header. Nilai defaultnya adalah Value.

CMFCPropertyGridCtrl::EndEditItem

Dipanggil oleh kerangka kerja ketika pengguna selesai memodifikasi properti.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parameter

bUpdateData
[di] TRUE untuk menentukan bahwa data properti yang dimodifikasi harus divalidasi ketika operasi edit selesai; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

TRUE jika operasi edit berhasil berakhir; FALSE jika data properti yang dimodifikasi tidak valid atau jika operasi pengeditan harus dilanjutkan.

Keterangan

CMFCPropertyGridCtrl::EnsureVisible

Menggulir kontrol kisi properti dan memperluas item properti hingga properti yang ditentukan terlihat.

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

Parameter

pProp
[di] Penunjuk ke properti.

bExpandParents
[di] TRUE untuk memperluas item induk agar properti yang ditentukan terlihat; jika tidak, FALSE. Default adalah FALSE.

Keterangan

CMFCPropertyGridCtrl::ExpandAll

Memperluas atau menciutkan semua simpul kontrol kisi properti.

void ExpandAll(BOOL bExpand=TRUE);

Parameter

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

Keterangan

CMFCPropertyGridCtrl::FindItemByData

Mengambil properti yang terkait dengan nilai yang ditentukan DWORD pengguna.

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

Parameter

dwData
[di] Nilai DWORD .

bSearchSubItems
[di] TRUE untuk mencari sub-item properti; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

Penunjuk ke objek properti terkait jika metode ini berhasil; jika tidak, NULL.

Keterangan

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Gunakan konstruktor atau CMFCPropertyGridProperty::SetData metode untuk mengaitkan DWORD dengan properti.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parameter

[di] pcountChildren

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parameter

[di] pvarChild

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Parameter

[di] varChild
[di] pszHelp

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parameter

[di] pszHelpFile
[di] varChild
[di] pidTopic

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Parameter

[di] varChild
[di] pszKeyboardShortcut

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parameter

[di] pvarChildren

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::GetBkColor

Mengambil warna latar belakang kontrol kisi properti saat ini.

COLORREF GetBkColor() const;

Tampilkan Nilai

Nilai warna RGB.

Keterangan

Metode ini mengambil warna yang digunakan kerangka kerja untuk menggambar latar belakang kontrol kisi properti saat ini. Metode ini CMFCPropertyGridCtrl::GetTextColor mengambil warna latar depan.

CMFCPropertyGridCtrl::GetBoldFont

Mengambil font Windows yang digunakan untuk menggambar teks dalam kontrol kisi properti saat ini dalam gaya tebal.

CFont& GetBoldFont();

Tampilkan Nilai

Referensi ke CFont objek yang menjelaskan karakteristik font tebal.

CMFCPropertyGridCtrl::GetCurSel

Mengambil properti yang saat ini dipilih.

CMFCPropertyGridProperty* GetCurSel() const;

Tampilkan Nilai

Penunjuk ke objek properti yang sesuai dengan item yang dipilih dalam kontrol kisi properti.

Keterangan

CMFCPropertyGridCtrl::GetCustomColors

Mengambil warna kustom yang saat ini ditentukan untuk elemen kontrol kisi properti.

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

Parameter

clrBackground
[out] Warna latar belakang nilai properti.

clrText
[out] Warna nama properti dan teks nilai properti.

clrGroupBackground
[out] Warna latar belakang grup properti.

clrGroupText
[out] Warna teks dalam grup properti.

clrDescriptionBackground
[out] Warna latar belakang area deskripsi.

clrDescriptionText
[out] Warna teks di area deskripsi.

clrLine
[out] Warna garis yang digambar di antara properti.

Keterangan

CMFCPropertyGridCtrl::SetCustomColors Gunakan metode untuk mengatur warna kustom.

CMFCPropertyGridCtrl::GetDescriptionHeight

Mengambil tinggi area deskripsi, yang terletak di bagian bawah kontrol kisi properti.

int GetDescriptionHeight() const;

Tampilkan Nilai

Tinggi area deskripsi, dalam piksel.

Keterangan

Tinggi area deskripsi dihitung secara otomatis dan diatur ke 1/4 tinggi kontrol kisi properti.

CMFCPropertyGridCtrl::EnableDescriptionArea Gunakan metode untuk menampilkan atau menyembunyikan area deskripsi. CMFCPropertyGridCtrl::IsDescriptionArea Gunakan metode untuk menentukan apakah area deskripsi ditampilkan atau disembunyikan.

CMFCPropertyGridCtrl::GetDescriptionRows

Mengambil jumlah baris di area deskripsi kontrol kisi properti saat ini.

int GetDescriptionRows() const;

Tampilkan Nilai

Jumlah baris di area deskripsi kontrol kisi properti saat ini.

Keterangan

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Konstruktor menginisialisasi area deskripsi menjadi 3 baris.

CMFCPropertyGridCtrl::GetHeaderCtrl

Mengambil objek internal CMFCHeaderCtrl yang digunakan kerangka kerja untuk menampilkan kontrol kisi properti saat ini.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Tampilkan Nilai

Referensi ke CMFCHeaderCtrl objek.

CMFCPropertyGridCtrl::GetHeaderHeight

Mengambil tinggi header kontrol kisi properti.

int GetHeaderHeight() const;

Tampilkan Nilai

Tinggi header, dalam piksel.

Keterangan

CMFCPropertyGridCtrl::GetLeftColumnWidth

Mengambil lebar kolom kiri kontrol kisi properti saat ini, yang berisi nama setiap properti.

int GetLeftColumnWidth() const;

Tampilkan Nilai

Lebar kolom nama.

Keterangan

Kolom kanan kontrol kisi properti berisi nilai setiap properti.

CMFCPropertyGridCtrl::GetListRect

Mengambil persegi panjang pembatas kontrol kisi properti.

CRect GetListRect() const;

Tampilkan Nilai

Persegi panjang pembatas kontrol kisi properti. Persegi panjang ini tidak menyertakan area deskripsi dan header.

Keterangan

CMFCPropertyGridCtrl::GetProperty

Mengambil penunjuk ke objek properti yang sesuai dengan indeks item yang ditentukan dalam kontrol kisi properti.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parameter

nIndex
[di] Indeks berbasis nol dari item kontrol kisi properti.

Metode ini menegaskan nIndex apakah parameter kurang dari nol atau lebih besar dari atau sama dengan jumlah properti.

Tampilkan Nilai

Penunjuk ke objek properti yang sesuai dengan indeks yang ditentukan jika metode ini berhasil; jika tidak, NULL.

Keterangan

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Mengambil lebar kolom saat ini yang berisi nilai properti.

int GetPropertyColumnWidth() const;

Tampilkan Nilai

Lebar kolom saat ini yang berisi nilai properti.

Keterangan

Kolom di sebelah kanan dalam kontrol kisi properti berisi nilai properti. Pelanggan dapat menggunakan kotak pemisah kontrol kisi properti untuk mengubah lebar kolom nilai.

CMFCPropertyGridCtrl::GetPropertyCount

Mengambil jumlah properti dalam kontrol kisi properti.

int GetPropertyCount() const;

Tampilkan Nilai

Jumlah properti.

Keterangan

CMFCPropertyGridCtrl::GetRowHeight

Mengambil tinggi baris dalam kontrol kisi properti.

int GetRowHeight() const;

Tampilkan Nilai

Tinggi baris.

Keterangan

Tinggi baris sama dengan tinggi font saat ini ditambah 4 piksel.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Mengambil penunjuk ke kontrol bilah gulir di kontrol kisi properti.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parameter

nBar
[di] Orientasi bilah gulir, yang harus SB_VERT.

Tampilkan Nilai

Penunjuk ke objek bilah gulir, atau NULL jika tidak ada bilah gulir atau orientasi bilah gulir adalah SB_HORZ.

Keterangan

Gunakan metode ini untuk mendapatkan akses langsung ke kontrol bilah gulir vertikal.

CMFCPropertyGridCtrl::GetTextColor

Mengambil warna yang digunakan untuk menggambar teks item properti dalam kontrol kisi properti saat ini.

COLORREF GetTextColor() const;

Tampilkan Nilai

Nilai warna RGB.

Keterangan

Metode ini mengambil warna yang digunakan kerangka kerja untuk menggambar latar depan kontrol kisi properti saat ini. Metode ini CMFCPropertyGridCtrl::GetBkColor mengambil warna latar belakang.

CMFCPropertyGridCtrl::HitTest

Mengambil penunjuk ke objek properti yang sesuai dengan item kontrol kisi properti jika titik yang ditentukan ada dalam item. Metode ini juga menunjukkan area dalam kontrol kisi properti yang berisi titik .

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

Parameter

pt
[di] Titik, dalam koordinat klien.

pnArea
[masuk, keluar] Penunjuk ke ClickArea variabel. Ketika metode ini kembali, variabel menunjukkan area properti yang berisi titik yang ditentukan. Untuk informasi selengkapnya tentang area properti, lihat Keterangan.

bPropsOnly
[di] TRUE untuk menguji hanya area properti; FALSE untuk menguji area deskripsi jika titik yang ditentukan tidak berada di area properti. Nilai defaultnya adalah FALSE. Untuk informasi selengkapnya tentang area deskripsi, lihat Keterangan.

Tampilkan Nilai

bPropsOnly Jika parameter adalah TRUE dan titik yang ditentukan berada di area properti, nilai yang dikembalikan adalah penunjuk ke objek properti yang sesuai. Selain itu, pnArea parameter diatur ke area tertentu yang berisi titik yang ditentukan. Jika tidak, nilai yang dikembalikan adalah NULL dan pnArea parameter tidak dimodifikasi.

bPropsOnly Jika parameter adalah FALSE, nilai yang dikembalikan selalu NULL. Namun, jika titik yang ditentukan berada di area deskripsi, pnArea parameter diatur ke CMFCPropertyGridProperty::ClickDescription.

Keterangan

Area properti istilah mengacu pada salah satu nama, nilai, atau area kotak perluas item kontrol kisi properti. Area deskripsi adalah zona di bagian bawah kontrol kisi properti. Saat Anda memilih item kontrol kisi properti, area deskripsi menampilkan deskripsi properti terkait.

Metode ini menetapkan nilai variabel yang dirujuk pnArea parameter. Tabel berikut mencantumkan nilai yang mungkin dan area terkait.

Nilai	Luas
ClickArea::ClickExpandBox	Kontrol kotak perluas properti.
ClickArea::ClickName	Nama properti.
ClickArea::ClickValue	Nilai properti.
CMFCPropertyGridProperty::ClickDescription	Area deskripsi kontrol kisi properti.

CMFCPropertyGridCtrl::Init

Dipanggil oleh kerangka kerja untuk menginisialisasi kontrol kisi properti.

virtual void Init();

Keterangan

CMFCPropertyGridCtrl::InitHeader

Menginisialisasi objek internal CMFCHeaderCtrl yang digunakan kerangka kerja untuk menampilkan kontrol kisi properti saat ini.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Menunjukkan apakah kontrol kisi properti dalam mode alfabet.

BOOL IsAlphabeticMode() const;

Tampilkan Nilai

TRUE jika kontrol kisi properti dalam mode alfabet; jika tidak FALSE.

Keterangan

Saat kontrol kisi properti dalam mode alfabet, semua properti diurutkan menurut abjad berdasarkan namanya. Jika tidak, properti dikelompokkan di bawah simpul induknya.

CMFCPropertyGridCtrl::SetAlphabeticMode Gunakan metode untuk mengaktifkan atau menonaktifkan mode alfabet.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Tampilkan Nilai

Keterangan

CMFCPropertyGridCtrl::IsDescriptionArea

Menunjukkan apakah area deskripsi kontrol kisi properti ditampilkan.

BOOL IsDescriptionArea() const;

Tampilkan Nilai

TRUE jika area deskripsi ditampilkan; jika tidak, FALSE.

Keterangan

CMFCPropertyGridCtrl::EnableDescriptionArea Gunakan metode untuk menyembunyikan atau menampilkan area deskripsi.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Menunjukkan apakah setiap nama grup properti ditampilkan di seluruh lebar kontrol kisi properti saat ini.

BOOL IsGroupNameFullWidth() const;

Tampilkan Nilai

TRUE jika nama grup ditampilkan di seluruh lebar kontrol kisi properti; FALSE jika nama grup dipotong oleh kolom kontrol (nilai) kanan.

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.

CMFCPropertyGridCtrl::IsHeaderCtrl

Menunjukkan apakah kontrol header ditampilkan.

BOOL IsHeaderCtrl() const;

Tampilkan Nilai

TRUE jika kontrol header ditampilkan; jika tidak FALSE.

Keterangan

CMFCPropertyGridCtrl::EnableHeaderCtrl Gunakan metode untuk menyembunyikan atau menampilkan kontrol header.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Menunjukkan bagaimana kontrol kisi properti menampilkan properti yang dimodifikasi.

BOOL IsMarkModifiedProperties() const;

Tampilkan Nilai

TRUE jika gaya tebal digunakan untuk menampilkan properti yang dimodifikasi; FALSE jika gaya reguler digunakan untuk menampilkan properti yang dimodifikasi.

Keterangan

CMFCPropertyGridCtrl::IsShowDragContext

Menunjukkan apakah kerangka kerja menggambar ulang kolom nama dan nilai kontrol kisi properti saat ini saat pengguna mengubah ukuran kolom.

BOOL IsShowDragContext() const;

Tampilkan Nilai

TRUE jika kerangka kerja menggambar ulang kolom nama dan nilai selama operasi mengubah ukuran; FALSE jika kerangka kerja menggambar ulang kolom setelah operasi seret selesai.

Keterangan

Pengguna dapat mengubah ukuran kolom nama dan nilai kontrol kisi properti dengan menyeret bilah pemisah yang berada di antara kolom. Jika konteks seret ditampilkan, kolom nama dan nilai akan diubah ukurannya selama pengguna menyeret bilah pemisah. Jika tidak, bilah pemisah bergerak tetapi kolom tidak digambar ulang hingga operasi seret selesai.

CMFCPropertyGridCtrl::IsVSDotNetLook

Menunjukkan apakah tampilan kontrol kisi properti dalam gaya Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Tampilkan Nilai

TRUE jika kontrol kisi properti berada dalam gaya Visual Studio .NET; jika tidak, FALSE.

Keterangan

CMFCPropertyGridCtrl::SetVSDotNetLook Gunakan metode untuk mengatur kontrol kisi properti ke gaya Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Menentukan cara menampilkan properti yang dimodifikasi.

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

Parameter

bMark
[di] TRUE untuk menampilkan properti yang dimodifikasi dalam gaya tebal; FALSE untuk menampilkan properti yang dimodifikasi dalam gaya reguler. Nilai defaultnya adalah TRUE.

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

Keterangan

CMFCPropertyGridCtrl::OnChangeSelection

Dipanggil oleh kerangka kerja ketika pilihan saat ini diubah.

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

Parameter

pNewSel
[di] Penunjuk ke properti yang baru dipilih.

pOldSel
[di] Penunjuk ke properti yang dipilih sebelumnya.

Keterangan

Implementasi default metode ini tidak melakukan apa pun.

CMFCPropertyGridCtrl::OnClickButton

Dipanggil oleh kerangka kerja saat tombol properti diklik.

virtual void OnClickButton(CPoint point);

Parameter

point
[di] Titik, dalam koordinat klien.

Keterangan

Secara default, metode ini memperbarui nilai properti saat ini.

CMFCPropertyGridCtrl::OnDrawBorder

Dipanggil oleh kerangka kerja untuk menggambar batas di sekitar kontrol kisi properti.

virtual void OnDrawBorder(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Keterangan

CMFCPropertyGridCtrl::OnDrawDescription

Dipanggil oleh kerangka kerja untuk menggambar area deskripsi dan menampilkan teks deskripsi.

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

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang yang menentukan tempat menggambar area deskripsi.

Keterangan

CMFCPropertyGridCtrl::EnableDescriptionArea Gunakan metode untuk menampilkan area deskripsi.

CMFCPropertyGridCtrl::OnDrawList

Dipanggil oleh kerangka kerja untuk menampilkan daftar properti dalam kontrol kisi properti.

virtual void OnDrawList(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Keterangan

CMFCPropertyGridCtrl::OnDrawProperty

Dipanggil oleh kerangka kerja untuk menampilkan properti.

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

pProp
[di] Penunjuk ke objek properti.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

CMFCPropertyGridCtrl::OnPropertyChanged

Dipanggil oleh kerangka kerja saat nilai properti diubah.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parameter

pProp
[di] Penunjuk ke objek properti yang nilainya telah berubah.

Keterangan

Secara default, metode ini mengirim AFX_WM_PROPERTY_CHANGED pesan ke pemilik kontrol kisi properti.

CMFCPropertyGridCtrl::OnSelectCombo

Dipanggil oleh kerangka kerja saat properti yang berisi kontrol kotak kombo dipilih.

void OnSelectCombo();

Keterangan

CMFCPropertyGridCtrl::RemoveAll

Menghapus semua objek properti dari kontrol kisi properti.

void RemoveAll();

Keterangan

CMFCPropertyGridCtrl::ResetOriginalValues

Memulihkan nilai asli semua properti.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parameter

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

Keterangan

CMFCPropertyGridCtrl::SetAlphabeticMode

Mengatur atau mengatur ulang mode alfabet.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parameter

bSet
[di] TRUE untuk mengatur mode alfabet; FALSE reset mode alfabet. Nilai defaultnya adalah TRUE.

Keterangan

Ketika kontrol kisi properti dalam mode alfabet, kontrol mengurutkan semua properti yang dikandungnya berdasarkan nama propertinya.

CMFCPropertyGridCtrl::SetBoolLabels

Menentukan teks label Boolean.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parameter

lpszTrue
[di] String teks yang ditampilkan untuk nilai Boolean true.

lpszFalse
[di] String teks yang ditampilkan untuk nilai Boolean false.

Keterangan

CMFCPropertyGridCtrl::SetCurSel

Memilih properti dalam kontrol kisi properti.

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

Parameter

pProp
[di] Penunjuk ke objek properti.

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

Keterangan

Gunakan metode ini untuk membatalkan pilihan item saat ini di kontrol kisi properti lalu pilih item yang sesuai dengan properti yang ditentukan.

CMFCPropertyGridCtrl::SetCustomColors

Menentukan warna kustom untuk berbagai elemen kontrol kisi properti.

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

Parameter

clrBackground
[di] Warna latar belakang nilai properti.

clrText
[di] Warna nama properti dan teks nilai properti.

clrGroupBackground
[di] Warna latar belakang grup properti.

clrGroupText
[di] Warna teks baru grup properti.

clrDescriptionBackground
[di] Warna latar belakang area deskripsi.

clrDescriptionText
[di] Warna teks di area deskripsi.

clrLine
[di] Warna garis yang digambar di antara properti.

Keterangan

Untuk parameter apa pun, tentukan ((COLORREF)-1) nilai warna untuk menggunakan warna default untuk elemen kontrol kisi properti tersebut.

Untuk menyesuaikan tampilan properti tertentu, dapatkan kelas dari CMFCPropertyGridProperty kelas lalu ambil alih CMFCPropertyGridProperty::OnDrawNamemetode , , CMFCPropertyGridProperty::OnDrawValueCMFCPropertyGridProperty::OnDrawExpandBox, dan CMFCPropertyGridProperty::OnDrawButton .

CMFCPropertyGridCtrl::SetDescriptionRows

Menentukan jumlah baris yang akan ditampilkan di bagian deskripsi kontrol kisi properti saat ini.

void SetDescriptionRows(int nDescRows);

Parameter

nDescRows
[di] Jumlah baris yang akan ditampilkan dalam deskripsi properti.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Menentukan apakah akan menampilkan lebar penuh nama kategori untuk sekelompok properti dalam kontrol kisi properti saat ini.

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

Parameter

bGroupNameFullWidth
[di] TRUE untuk menampilkan lebar lengkap nama kategori terlepas dari lebar kolom nama properti. FALSE untuk membatasi lebar nama kategori ke lebar kolom nama properti. Nilai defaultnya adalah TRUE.

bRedraw
[di] TRUE untuk segera memperbarui kontrol kisi properti; FALSE untuk memperbarui kontrol saat peristiwa redraw berikutnya terjadi. Nilai defaultnya adalah TRUE.

Keterangan

Kontrol kisi properti terdiri dari kolom nama properti yang dapat diubah ukurannya dan kolom nilai properti. Akhir kolom nama juga merupakan awal kolom nilai. Untuk mengubah ukuran kolom, seret batas di antara kolom.

Istilah nama grup dan nama kategori digunakan secara bergantian dalam metode ini. Nama kategori ditampilkan pada baris yang mengepalai sekumpulan properti dan nilai terkait. Metode ini menentukan apakah lebar kolom nama properti juga menentukan lebar nama kategori yang ditampilkan.

CMFCPropertyGridCtrl::SetListDelimiter

Menentukan karakter yang digunakan sebagai pemisah dalam daftar nilai properti.

void SetListDelimiter(TCHAR c);

Parameter

c
[di] Karakter untuk berfungsi sebagai pemisah.

Keterangan

Gunakan metode ini untuk menentukan karakter pemisah dalam daftar nilai properti yang digunakan dalam CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktor. Dalam konstruktor tersebut, atur parameter ke bIsValueListTRUE.

Secara default, CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor mengatur karakter pemisah ke koma (',').

CMFCPropertyGridCtrl::SetShowDragContext

Menentukan apakah kerangka kerja menggambar ulang kolom nama dan nilai kontrol kisi properti saat ini saat pengguna mengubah ukuran kolom.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parameter

bShowDragContext
[di] TRUE untuk menggambar ulang kolom nama dan nilai selama operasi mengubah ukuran; FALSE untuk menggambar ulang kolom setelah operasi seret selesai. Nilai defaultnya adalah TRUE.

Keterangan

Pengguna dapat mengubah ukuran kolom nama dan nilai kontrol kisi properti dengan menyeret bilah pemisah yang berada di antara kolom. Jika konteks seret ditampilkan, kolom nama dan nilai akan diubah ukurannya selama pengguna menyeret bilah pemisah. Jika tidak, bilah pemisah bergerak tetapi kolom tidak digambar ulang hingga operasi seret selesai.

CMFCPropertyGridCtrl::SetVSDotNetLook

Mengatur tampilan kontrol kisi properti ke gaya yang digunakan di Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parameter

bSet
[di] TRUE untuk mengatur kontrol kisi properti ke gaya yang digunakan di Visual Studio .NET; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CMFCPropertyGridCtrl::UpdateColor

Menyetel nilai warna properti warna yang saat ini dipilih.

virtual void UpdateColor(COLORREF color);

Parameter

color
[di] Nilai warna RGB.

Keterangan

Metode ini menegaskan dalam mode debug jika properti yang saat ini dipilih dari kontrol kisi properti bukan properti warna.

CMFCPropertyGridCtrl::ValidateItemData

Dipanggil oleh kerangka kerja untuk memvalidasi data properti.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parameter

pProp
[di] Penunjuk ke properti. Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu TRUE.

Keterangan

Metode CMFCPropertyGridCtrl::EndEditItem ini memanggil metode ini untuk memvalidasi data. Secara default, metode ini tidak menggunakan parameternya pProp dan nilai pengembaliannya selalu TRUE.

Jika Anda mengambil alih metode ini, kembalikan TRUE jika data properti yang ditentukan valid. Jika tidak, kembalikan FALSE, dalam hal ini kerangka kerja tidak memperbarui properti .

Lihat juga

Bagan Hierarki
Kelas