Bagikan melalui

Halaman Properti (MFC)

  • Artikel

Halaman properti menampilkan nilai properti kontrol OLE tertentu saat ini dalam antarmuka grafis yang dapat disesuaikan untuk menampilkan dan mengedit dengan mendukung mekanisme pemetaan data berdasarkan pertukaran data dialog (DDX).

Mekanisme pemetaan data ini memetakan kontrol halaman properti ke properti individual kontrol OLE. Nilai properti kontrol mencerminkan status atau konten kontrol halaman properti. Pemetaan antara kontrol halaman properti dan properti ditentukan oleh DDP_ panggilan fungsi di fungsi anggota halaman DoDataExchange properti. Berikut ini adalah daftar fungsi DDP_ yang bertukar data yang dimasukkan menggunakan halaman properti kontrol Anda:

Transfer Data Halaman Properti

Nama Deskripsi
DDP_CBIndex Menautkan indeks string yang dipilih dalam kotak kombo dengan properti kontrol.
DDP_CBString Menautkan string yang dipilih dalam kotak kombo dengan properti kontrol. String yang dipilih dapat dimulai dengan huruf yang sama dengan nilai properti tetapi tidak perlu mencocokkannya sepenuhnya.
DDP_CBStringExact Menautkan string yang dipilih dalam kotak kombo dengan properti kontrol. String yang dipilih dan nilai string properti harus sama persis.
DDP_Check Menautkan kotak centang di halaman properti kontrol dengan properti kontrol.
DDP_LBIndex Menautkan indeks string yang dipilih dalam kotak daftar dengan properti kontrol.
DDP_LBString Menautkan string yang dipilih dalam kotak daftar dengan properti kontrol. String yang dipilih dapat dimulai dengan huruf yang sama dengan nilai properti tetapi tidak perlu mencocokkannya sepenuhnya.
DDP_LBStringExact Menautkan string yang dipilih dalam kotak daftar dengan properti kontrol. String yang dipilih dan nilai string properti harus sama persis.
DDP_PostProcessing Menyelesaikan transfer nilai properti dari kontrol Anda.
DDP_Radio Menautkan grup tombol radio di halaman properti kontrol dengan properti kontrol.
DDP_Text Menautkan kontrol di halaman properti kontrol dengan properti kontrol. Fungsi ini menangani beberapa jenis properti yang berbeda, seperti double, , shortBSTR, dan long.

Untuk informasi selengkapnya tentang DoDataExchange halaman fungsi dan properti, lihat artikel Kontrol ActiveX: Halaman Properti.

Berikut ini adalah daftar makro yang digunakan untuk membuat dan mengelola halaman properti untuk kontrol OLE:

Halaman Properti

Nama Deskripsi
BEGIN_PROPPAGEIDS Memulai daftar ID halaman properti.
END_PROPPAGEIDS Mengakhiri daftar ID halaman properti.
PROPPAGEID Mendeklarasikan halaman properti kelas kontrol.

DDP_CBIndex

Panggil fungsi ini dalam fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti bilangan bulat dengan indeks pilihan saat ini dalam kotak kombo di halaman properti.

void AFXAPI DDP_CBIndex(
    CDataExchange* pDX,
    int id,
    int& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak kombo yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan kontrol kotak kombo yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_CBIndex sesuai.

Persyaratan

Header afxctl.h

DDP_CBString

Panggil fungsi ini di fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti string dengan pilihan saat ini dalam kotak kombo di halaman properti.

void AFXAPI DDP_CBString(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak kombo yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan string kotak kombo yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_CBString sesuai.

Persyaratan

Header afxctl.h

DDP_CBStringExact

Panggil fungsi ini dalam fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti string yang sama persis dengan pilihan saat ini dalam kotak kombo di halaman properti.

void AFXAPI DDP_CBStringExact(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak kombo yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan string kotak kombo yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_CBStringExact sesuai.

Persyaratan

Header afxctl.h

DDP_Check

Panggil fungsi ini dalam fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti dengan kontrol kotak centang halaman properti terkait.

void AFXAPI DDP_Check(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak centang yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan kontrol kotak centang yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_Check sesuai.

Persyaratan

Header afxctl.h

DDP_LBIndex

Panggil fungsi ini di fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti bilangan bulat dengan indeks pilihan saat ini dalam kotak daftar di halaman properti.

void AFXAPI DDP_LBIndex(
    CDataExchange* pDX,
    int id,
    int& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak daftar yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan string kotak daftar yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_LBIndex sesuai.

Persyaratan

Header afxctl.h

DDP_LBString

Panggil fungsi ini di fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti string dengan pilihan saat ini dalam kotak daftar di halaman properti.

void AFXAPI DDP_LBString(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak daftar yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan string kotak daftar yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_LBString sesuai.

Persyaratan

Header afxctl.h

DDP_LBStringExact

Panggil fungsi ini di fungsi halaman DoDataExchange properti Anda untuk menyinkronkan nilai properti string yang sama persis dengan pilihan saat ini dalam kotak daftar di halaman properti.

void AFXAPI DDP_LBStringExact(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol kotak daftar yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan string kotak daftar yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_LBStringExact sesuai.

Persyaratan

Header afxctl.h

DDP_PostProcessing

Panggil fungsi ini dalam fungsi halaman DoDataExchange properti Anda, untuk menyelesaikan transfer nilai properti dari halaman properti ke kontrol Anda saat nilai properti sedang disimpan.

void AFXAPI DDP_PostProcessing(CDataExchange * pDX);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

Keterangan

Fungsi ini harus dipanggil setelah semua fungsi pertukaran data selesai. Contohnya:

void CMyAxPropPage::DoDataExchange(CDataExchange *pDX)
{
   DDP_Text(pDX, IDC_POSITIONEDIT, m_NeedlePosition, _T("NeedlePosition"));
   DDX_Text(pDX, IDC_POSITIONEDIT, m_NeedlePosition);
   DDV_MinMaxInt(pDX, m_NeedlePosition, 0, 3);
   DDP_PostProcessing(pDX);
}

Persyaratan

Header afxctl.h

DDP_Radio

Panggil fungsi ini dalam fungsi kontrol DoPropExchange Anda untuk menyinkronkan nilai properti dengan kontrol tombol radio halaman properti terkait.

void AFXAPI DDP_Radio(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol tombol radio yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan kontrol tombol radio yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_Radio sesuai.

Persyaratan

Header afxctl.h

DDP_Text

Panggil fungsi ini dalam fungsi kontrol DoDataExchange Anda untuk menyinkronkan nilai properti dengan kontrol halaman properti terkait.

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    BYTE & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    UINT & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    long & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    DWORD & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    float & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    double & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    CString & member,
    LPCTSTR pszPropName);

Parameter

pDX
Penunjuk CDataExchange ke objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.

id
ID sumber daya kontrol yang terkait dengan properti kontrol yang ditentukan oleh pszPropName.

anggota
Variabel anggota yang terkait dengan kontrol halaman properti yang ditentukan oleh id dan properti yang ditentukan oleh pszPropName.

pszPropName
Nama properti properti kontrol yang akan ditukar dengan kontrol yang ditentukan oleh id.

Keterangan

Fungsi ini harus dipanggil sebelum panggilan fungsi yang DDX_Text sesuai.

Persyaratan

Header afxctl.h

BEGIN_PROPPAGEIDS

Memulai definisi daftar ID halaman properti kontrol Anda.

BEGIN_PROPPAGEIDS(class_name,  count)

Parameter

class_name
Nama kelas kontrol tempat halaman properti ditentukan.

count
Jumlah halaman properti yang digunakan oleh kelas kontrol.

Keterangan

Dalam file implementasi (.cpp) yang menentukan fungsi anggota untuk kelas Anda, mulai daftar halaman properti dengan makro BEGIN_PROPPAGEIDS, lalu tambahkan entri makro untuk setiap halaman properti Anda, dan lengkapi daftar halaman properti dengan makro END_PROPPAGEIDS.

Untuk informasi selengkapnya tentang halaman properti, lihat artikel Kontrol ActiveX: Halaman Properti.

Persyaratan

Header afxctl.h

END_PROPPAGEIDS

Mengakhiri definisi daftar ID halaman properti Anda.

END_PROPPAGEIDS(class_name)

Parameter

class_name
Nama kelas kontrol yang memiliki halaman properti.

Persyaratan

Header afxctl.h

PROPPAGEID

Menambahkan halaman properti untuk digunakan oleh kontrol OLE Anda.

PROPPAGEID(clsid)

Parameter

clsid
ID kelas unik dari halaman properti.

Keterangan

Semua makro PROPPAGEID harus ditempatkan antara makro BEGIN_PROPPAGEIDS dan END_PROPPAGEIDS dalam file implementasi kontrol Anda.

Persyaratan

Header afxctl.h

Lihat juga

Makro dan Global