Stránky vlastností (MFC)

Stránky vlastností zobrazují aktuální hodnoty konkrétních vlastností ovládacího prvku OLE v přizpůsobitelném grafickém rozhraní pro zobrazení a úpravy pomocí mechanismu mapování dat na základě výměny dat dialogového okna (DDX).

Tento mechanismus mapování dat mapuje ovládací prvky stránky vlastností na jednotlivé vlastnosti ovládacího prvku OLE. Hodnota vlastnosti ovládacího prvku odráží stav nebo obsah ovládacího prvku stránky vlastnosti. Mapování mezi ovládacími prvky stránky vlastností a vlastnostmi je určeno voláním funkce DDP_ ve členské funkci stránky DoDataExchange vlastností. Následuje seznam DDP_ funkcí, které vyměňují data zadaná pomocí stránky vlastností ovládacího prvku:

Přenos dat stránky vlastností

Název	Popis
DDP_CBIndex	Prodá index vybraného řetězce v poli se seznamem s vlastností ovládacího prvku.
DDP_CBString	Pro propojení vybraného řetězce v poli se seznamem s vlastností ovládacího prvku. Vybraný řetězec může začínat stejnými písmeny jako hodnota vlastnosti, ale nemusí se shodovat úplně.
DDP_CBStringExact	Pro propojení vybraného řetězce v poli se seznamem s vlastností ovládacího prvku. Vybraný řetězec a hodnota řetězce vlastnosti se musí přesně shodovat.
DDP_Check	Umožňuje propojit zaškrtávací políčko na stránce vlastností ovládacího prvku s vlastností ovládacího prvku.
DDP_LBIndex	Pro propojení indexu vybraného řetězce v seznamu s vlastností ovládacího prvku.
DDP_LBString	Pro propojení vybraného řetězce v seznamu s vlastností ovládacího prvku. Vybraný řetězec může začínat stejnými písmeny jako hodnota vlastnosti, ale nemusí se shodovat úplně.
DDP_LBStringExact	Pro propojení vybraného řetězce v seznamu s vlastností ovládacího prvku. Vybraný řetězec a hodnota řetězce vlastnosti se musí přesně shodovat.
DDP_PostProcessing	Dokončí přenos hodnot vlastností z ovládacího prvku.
DDP_Radio	Umožňuje propojit skupinu přepínačů na stránce vlastností ovládacího prvku s vlastností ovládacího prvku.
DDP_Text	Umožňuje propojit ovládací prvek na stránce vlastností ovládacího prvku s vlastností ovládacího prvku. Tato funkce zpracovává několik různých typů vlastností, například double, , shortBSTR a long.

Další informace o DoDataExchange stránkách funkcí a vlastností najdete v článku Ovládací prvky ActiveX: Stránky vlastností.

Následuje seznam maker použitých k vytvoření a správě stránek vlastností pro ovládací prvek OLE:

Stránky vlastností

Název	Popis
BEGIN_PROPPAGEIDS	Začíná seznam ID stránek vlastností.
END_PROPPAGEIDS	Ukončí seznam ID stránek vlastností.
PROPPAGEID	Deklaruje stránku vlastnosti třídy ovládacího prvku.

DDP_CBIndex

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu celočíselné vlastnosti s indexem aktuálního výběru v poli se seznamem na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku pole se seznamem přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s ovládacím prvku pole se seznamem určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_CBIndex voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_CBString

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu vlastnosti řetězce s aktuálním výběrem v poli se seznamem na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku pole se seznamem přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s řetězcem pole se seznamem určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_CBString voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_CBStringExact

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu vlastnosti řetězce, která přesně odpovídá aktuálnímu výběru v poli se seznamem na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku pole se seznamem přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s řetězcem pole se seznamem určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_CBStringExact voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_Check

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu vlastnosti s ovládacím polem přidružené stránky vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku zaškrtávacího políčka přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s ovládacím prvku zaškrtávacím políčku určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_Check voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_LBIndex

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu celočíselné vlastnosti s indexem aktuálního výběru v seznamu na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku seznamu přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s řetězcem seznamu určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_LBIndex voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_LBString

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu vlastnosti řetězce s aktuálním výběrem v seznamu na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku seznamu přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s řetězcem seznamu určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_LBString voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_LBStringExact

Voláním této funkce ve funkci stránky DoDataExchange vlastností můžete synchronizovat hodnotu vlastnosti řetězce, která přesně odpovídá aktuálnímu výběru v seznamu na stránce vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku seznamu přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který se má vyměnit s řetězcem seznamu určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_LBStringExact voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_PostProcessing

Voláním této funkce ve funkci stránky DoDataExchange vlastností dokončíte přenos hodnot vlastností ze stránky vlastností do ovládacího prvku při ukládání hodnot vlastností.

void AFXAPI DDP_PostProcessing(CDataExchange * pDX);

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

Poznámky

Tato funkce by se měla volat po dokončení všech funkcí výměny dat. Příklad:

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);
}

Požadavky

Záhlaví afxctl.h

DDP_Radio

Voláním této funkce ve funkci ovládacího prvku DoPropExchange můžete synchronizovat hodnotu vlastnosti s ovládacím tlačítkem přidružené stránky vlastností.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku přepínače přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který má být vyměněn s přepínačem určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_Radio voláním funkce.

Požadavky

Záhlaví afxctl.h

DDP_Text

Voláním této funkce ve funkci ovládacího prvku DoDataExchange můžete synchronizovat hodnotu vlastnosti s přidruženým ovládacím prvku stránky vlastností.

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);

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

id
ID prostředku ovládacího prvku přidruženého k vlastnosti ovládacího prvku určené pszPropName.

člen
Proměnná člena přidružená k ovládacímu prvku stránky vlastností určeného id a vlastnost určenou pszPropName.

pszPropName
Název vlastnosti ovládacího prvku, který má být vyměněn s ovládacím prvku určeným ID.

Poznámky

Tato funkce by měla být volána před odpovídajícím DDX_Text voláním funkce.

Požadavky

Záhlaví afxctl.h

BEGIN_PROPPAGEIDS

Zahájí definici seznamu ID stránek vlastností ovládacího prvku.

BEGIN_PROPPAGEIDS(class_name,  count)

Parametry

class_name
Název třídy ovládacího prvku, pro kterou jsou zadány stránky vlastností.

count
Počet stránek vlastností používaných třídou ovládacího prvku.

Poznámky

V souboru implementace (.cpp), který definuje členské funkce pro vaši třídu, spusťte seznam stránek vlastností pomocí BEGIN_PROPPAGEIDS makra, přidejte položky makra pro každou stránku vlastností a vyplňte seznam stránek vlastností pomocí END_PROPPAGEIDS makra.

Další informace o stránkách vlastností naleznete v článku Ovládací prvky ActiveX: Stránky vlastností.

Požadavky

Záhlaví afxctl.h

END_PROPPAGEIDS

Ukončí definici seznamu ID stránky vlastností.

END_PROPPAGEIDS(class_name)

Parametry

class_name
Název třídy ovládacího prvku, která vlastní stránku vlastnosti.

Požadavky

Záhlaví afxctl.h

PROPPAGEID

Přidá stránku vlastností pro použití ovládacím prvku OLE.

PROPPAGEID(clsid)

Parametry

clsid
Jedinečné ID třídy stránky vlastností.

Poznámky

Všechna makra PROPPAGEID musí být umístěna mezi BEGIN_PROPPAGEIDS a END_PROPPAGEIDS makry v souboru implementace vašeho ovládacího prvku.

Požadavky

Záhlaví afxctl.h

Viz také

Makra a globální objekty