Özellik Sayfaları (MFC)
Özellik sayfaları, iletişim kutusu veri değişimini (DDX) temel alan bir veri eşleme mekanizmasını destekleyerek görüntülemek ve düzenlemek için özelleştirilebilir, grafik bir arabirimde belirli OLE denetimi özelliklerinin geçerli değerlerini görüntüler.
Bu veri eşleme mekanizması özellik sayfası denetimlerini OLE denetiminin tek tek özellikleriyle eşler. Denetim özelliğinin değeri, özellik sayfası denetiminin durumunu veya içeriğini yansıtır. Özellik sayfası denetimleri ve özellikleri arasındaki eşleme, özellik sayfasının DoDataExchange üye işlevindeki DDP_ işlev çağrıları tarafından belirtilir. Aşağıda, denetiminizin özellik sayfası kullanılarak girilen veri alışverişinde bulunan DDP_ işlevlerin listesi yer alır:
Özellik Sayfası Veri Aktarımı
| Veri Akışı Adı | Açıklama |
|---|---|
| DDP_CBIndex | Seçili dizenin dizinini bir birleşik giriş kutusuna bir denetimin özelliğiyle bağlar. |
| DDP_CBString | Seçili dizeyi birleşik giriş kutusuna bir denetimin özelliğiyle bağlar. Seçili dize, özelliğin değeriyle aynı harflerle başlayabilir, ancak tam olarak eşleşmesi gerekmez. |
| DDP_CBStringExact | Seçili dizeyi birleşik giriş kutusuna bir denetimin özelliğiyle bağlar. Seçili dize ve özelliğin dize değeri tam olarak eşleşmelidir. |
| DDP_Check | Denetimin özellik sayfasındaki bir onay kutusunu denetimin özelliğine bağlar. |
| DDP_LBIndex | Seçili dizenin dizinini bir liste kutusuna bir denetimin özelliğiyle bağlar. |
| DDP_LBString | Liste kutusundaki seçili dizeyi denetimin özelliğine bağlar. Seçili dize, özelliğin değeriyle aynı harflerle başlayabilir ancak tam olarak eşleşmesi gerekmez. |
| DDP_LBStringExact | Liste kutusundaki seçili dizeyi denetimin özelliğine bağlar. Seçili dize ve özelliğin dize değeri tam olarak eşleşmelidir. |
| DDP_PostProcessing | Denetiminizden özellik değerlerinin aktarımını tamamlar. |
| DDP_Radio | Denetimin özellik sayfasındaki bir radyo düğmesi grubunu denetimin özelliğiyle bağlar. |
| DDP_Text | Denetimin özellik sayfasındaki bir denetimi bir denetimin özelliğine bağlar. Bu işlev, , short, BSTR ve longgibi doublebirkaç farklı özellik türünü işler. |
İşlev ve özellik sayfaları hakkında DoDataExchange daha fazla bilgi için ActiveX Denetimleri: Özellik Sayfaları makalesine bakın.
Aşağıda, OLE denetimi için özellik sayfaları oluşturmak ve yönetmek için kullanılan makroların listesi yer alır:
Özellik Sayfaları
| Veri Akışı Adı | Açıklama |
|---|---|
| BEGIN_PROPPAGEIDS | Özellik sayfası kimlikleri listesini başlatır. |
| END_PROPPAGEIDS | Özellik sayfası kimlikleri listesini sonlandırır. |
| PROPPAGEID | Denetim sınıfının özellik sayfasını bildirir. |
DDP_CBIndex
Bir tamsayı özelliğinin değerini özellik sayfasındaki DoDataExchange birleşik giriş kutusundaki geçerli seçimin diziniyle eşitlemek için özellik sayfanızın işlevinde bu işlevi çağırın.
void AFXAPI DDP_CBIndex(
CDataExchange* pDX,
int id,
int& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili birleşik giriş kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen birleşik giriş kutusu denetimiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_CBIndex işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_CBString
Bir dize özelliğinin değerini özellik sayfasındaki birleşik giriş kutusundaki geçerli seçimle eşitlemek için özellik sayfanızın DoDataExchange işlevinde bu işlevi çağırın.
void AFXAPI DDP_CBString(
CDataExchange* pDX,
int id,
CString& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili birleşik giriş kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen birleşik giriş kutusu dizesiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_CBString işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_CBStringExact
Özellik sayfasındaki birleşik giriş kutusundaki DoDataExchange geçerli seçimle tam olarak eşleşen bir dize özelliğinin değerini eşitlemek için özellik sayfanızın işlevinde bu işlevi çağırın.
void AFXAPI DDP_CBStringExact(
CDataExchange* pDX,
int id,
CString& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili birleşik giriş kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen birleşik giriş kutusu dizesiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_CBStringExact işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_Check
Özelliğin değerini ilişkili özellik sayfası DoDataExchange onay kutusu denetimiyle eşitlemek için özellik sayfanızın işlevinde bu işlevi çağırın.
void AFXAPI DDP_Check(
CDataExchange* pDX,
int id,
int & member,
LPCSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili onay kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen onay kutusu denetimiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_Check işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_LBIndex
Bir tamsayı özelliğinin değerini özellik sayfasındaki DoDataExchange liste kutusundaki geçerli seçimin diziniyle eşitlemek için özellik sayfanızın işlevinde bu işlevi çağırın.
void AFXAPI DDP_LBIndex(
CDataExchange* pDX,
int id,
int& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili liste kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen liste kutusu dizesiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_LBIndex işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_LBString
Bir dize özelliğinin değerini özellik sayfasındaki liste kutusundaki geçerli seçimle eşitlemek için özellik sayfanızın DoDataExchange işlevinde bu işlevi çağırın.
void AFXAPI DDP_LBString(
CDataExchange* pDX,
int id,
CString& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili liste kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen liste kutusu dizesiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_LBString işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_LBStringExact
Özellik sayfasındaki DoDataExchange liste kutusunda geçerli seçimle tam olarak eşleşen bir dize özelliğinin değerini eşitlemek için özellik sayfanızın işlevinde bu işlevi çağırın.
void AFXAPI DDP_LBStringExact(
CDataExchange* pDX,
int id,
CString& member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili liste kutusu denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen liste kutusu dizesiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_LBStringExact işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_PostProcessing
Özellik değerlerinin özellik sayfasından, özellik değerleri kaydedilirken denetiminize aktarılmasını tamamlamak için özellik sayfanızın DoDataExchange işlevinde bu işlevi çağırın.
void AFXAPI DDP_PostProcessing(CDataExchange * pDX);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
Açıklamalar
Tüm veri değişimi işlevleri tamamlandıktan sonra bu işlev çağrılmalıdır. Örneğin:
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);
}
Gereksinimler
Üst bilgi afxctl.h
DDP_Radio
Özelliğin değerini ilişkili özellik sayfası radyo düğmesi denetimiyle eşitlemek için denetiminizin DoPropExchange işlevinde bu işlevi çağırın.
void AFXAPI DDP_Radio(
CDataExchange* pDX,
int id,
int & member,
LPCTSTR pszPropName);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili radyo düğmesi denetiminin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen radyo düğmesi denetimiyle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_Radio işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
DDP_Text
Özelliğin değerini ilişkili özellik sayfası denetimiyle eşitlemek için denetiminizin DoDataExchange işlevinde bu işlevi çağırın.
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);
Parametreler
pDX
Nesne CDataExchange işaretçisi. Çerçeve, bu nesneyi yönü de dahil olmak üzere veri alışverişinin bağlamını oluşturmak için sağlar.
id
pszPropName tarafından belirtilen denetim özelliğiyle ilişkili denetimin kaynak kimliği.
üye
kimlik ve pszPropName tarafından belirtilen özellik tarafından belirtilen özellik sayfası denetimiyle ilişkilendirilmiş üye değişkeni.
pszPropName
Kimlik tarafından belirtilen denetimle değiştirilecek denetim özelliğinin özellik adı.
Açıklamalar
Bu işlev, karşılık gelen DDX_Text işlev çağrısından önce çağrılmalıdır.
Gereksinimler
Üst bilgi afxctl.h
BEGIN_PROPPAGEIDS
Denetiminizin özellik sayfası kimlikleri listesinin tanımını başlatır.
BEGIN_PROPPAGEIDS(class_name, count)
Parametreler
class_name
Özellik sayfalarının belirtildiği denetim sınıfının adı.
count
Denetim sınıfı tarafından kullanılan özellik sayfalarının sayısı.
Açıklamalar
Sınıfınızın üye işlevlerini tanımlayan uygulama (.cpp) dosyasında, özellik sayfası listesini BEGIN_PROPPAGEIDS makroyla başlatın, ardından özellik sayfalarınızın her biri için makro girdileri ekleyin ve özellik sayfası listesini END_PROPPAGEIDS makroyla tamamlayın.
Özellik sayfaları hakkında daha fazla bilgi için ActiveX Denetimleri: Özellik Sayfaları makalesine bakın.
Gereksinimler
Üst bilgi afxctl.h
END_PROPPAGEIDS
Özellik sayfası kimliği listenizin tanımını sonlandırır.
END_PROPPAGEIDS(class_name)
Parametreler
class_name
Özellik sayfasının sahibi olan denetim sınıfının adı.
Gereksinimler
Üst bilgi afxctl.h
PROPPAGEID
OLE denetiminiz tarafından kullanılmak üzere bir özellik sayfası ekler.
PROPPAGEID(clsid)
Parametreler
clsid
Özellik sayfasının benzersiz sınıf kimliği.
Açıklamalar
Tüm PROPPAGEID makroları, denetiminizin uygulama dosyasındaki BEGIN_PROPPAGEIDS ve END_PROPPAGEIDS makroları arasına yerleştirilmelidir.
Gereksinimler
Üst bilgi afxctl.h