Udostępnij za pośrednictwem

Strony właściwości (MFC)

  • Artykuł

Strony właściwości wyświetlają bieżące wartości określonych właściwości kontrolki OLE w dostosowywalnym interfejsie graficznym do wyświetlania i edytowania przez obsługę mechanizmu mapowania danych na podstawie wymiany danych dialogowych (DDX).

Ten mechanizm mapowania danych mapuje kontrolki strony właściwości na poszczególne właściwości kontrolki OLE. Wartość właściwości kontrolki odzwierciedla stan lub zawartość kontrolki strony właściwości. Mapowanie między kontrolkami i właściwościami właściwości jest określane przez wywołania funkcji DDP_ w funkcji składowej strony DoDataExchange właściwości. Poniżej znajduje się lista funkcji DDP_ , które wymieniają dane wprowadzone przy użyciu strony właściwości kontrolki:

Transfer danych strony właściwości

Nazwa/nazwisko opis
DDP_CBIndex Łączy indeks wybranego ciągu w polu kombi z właściwością kontrolki.
DDP_CBString Łączy wybrany ciąg w polu kombi z właściwością kontrolki. Wybrany ciąg może zaczynać się od tych samych liter co wartość właściwości, ale nie musi być w pełni zgodny.
DDP_CBStringExact Łączy wybrany ciąg w polu kombi z właściwością kontrolki. Wybrany ciąg i wartość ciągu właściwości muszą być dokładnie zgodne.
DDP_Check Łączy pole wyboru na stronie właściwości kontrolki z właściwością kontrolki.
DDP_LBIndex Łączy indeks wybranego ciągu w polu listy z właściwością kontrolki.
DDP_LBString Łączy wybrany ciąg w polu listy z właściwością kontrolki. Wybrany ciąg może zaczynać się od tych samych liter co wartość właściwości, ale nie musi być w pełni zgodny.
DDP_LBStringExact Łączy wybrany ciąg w polu listy z właściwością kontrolki. Wybrany ciąg i wartość ciągu właściwości muszą być dokładnie zgodne.
DDP_PostProcessing Kończy transfer wartości właściwości z kontrolki.
DDP_Radio Łączy grupę przycisków radiowych na stronie właściwości kontrolki z właściwością kontrolki.
DDP_Text Łączy kontrolkę na stronie właściwości kontrolki z właściwością kontrolki. Ta funkcja obsługuje kilka różnych typów właściwości, takich jak double, , shortBSTR i long.

Aby uzyskać więcej informacji na temat DoDataExchange stron funkcji i właściwości, zobacz artykuł Kontrolki ActiveX: strony właściwości.

Poniżej znajduje się lista makr używanych do tworzenia stron właściwości dla kontrolki OLE i zarządzania nimi:

strony właściwości

Nazwa/nazwisko opis
BEGIN_PROPPAGEIDS Rozpoczyna listę identyfikatorów stron właściwości.
END_PROPPAGEIDS Kończy listę identyfikatorów stron właściwości.
IDENTYFIKATOR PROPPAGEID Deklaruje stronę właściwości klasy kontrolnej.

DDP_CBIndex

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości całkowitej z indeksem bieżącego zaznaczenia w polu kombi na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola kombi skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą kontrolki pola kombi określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_CBIndex wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_CBString

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości ciągu z bieżącym zaznaczeniem w polu kombi na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola kombi skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości właściwości, która ma być wymieniana za pomocą ciągu pola kombi określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_CBString wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_CBStringExact

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości ciągu, która dokładnie pasuje do bieżącego zaznaczenia w polu kombi na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola kombi skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości właściwości, która ma być wymieniana za pomocą ciągu pola kombi określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_CBStringExact wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_Check

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości ze skojarzoną kontrolką pola wyboru strony właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola wyboru skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą kontrolki pola wyboru określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_Check wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_LBIndex

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości całkowitej z indeksem bieżącego zaznaczenia w polu listy na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola listy skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą ciągu pola listy określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_LBIndex wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_LBString

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości ciągu z bieżącym zaznaczeniem w polu listy na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola listy skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą ciągu pola listy określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_LBString wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_LBStringExact

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zsynchronizować wartość właściwości ciągu, która dokładnie pasuje do bieżącego zaznaczenia w polu listy na stronie właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki pola listy skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą ciągu pola listy określonego przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_LBStringExact wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_PostProcessing

Wywołaj tę funkcję w funkcji strony DoDataExchange właściwości, aby zakończyć transfer wartości właściwości ze strony właściwości do kontrolki, gdy wartości właściwości są zapisywane.

void AFXAPI DDP_PostProcessing(CDataExchange * pDX);

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

Uwagi

Ta funkcja powinna być wywoływana po zakończeniu wszystkich funkcji wymiany danych. Na przykład:

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

Wymagania

Nagłówek afxctl.h

DDP_Radio

Wywołaj tę funkcję w funkcji kontrolki DoPropExchange , aby zsynchronizować wartość właściwości ze skojarzonym kontrolką przycisku radiowego strony właściwości.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki przycisku radiowego skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana za pomocą kontrolki przycisku radiowego określonej przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_Radio wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

DDP_Text

Wywołaj tę funkcję w funkcji kontrolki DoDataExchange , aby zsynchronizować wartość właściwości z skojarzona kontrolka strony właściwości.

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
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

id
Identyfikator zasobu kontrolki skojarzonej z właściwością kontrolki określoną przez pszPropName.

członek
Zmienna składowa skojarzona z kontrolką strony właściwości określona przez identyfikator i właściwość określona przez pszPropName.

pszPropName
Nazwa właściwości kontrolki, która ma być wymieniana z kontrolką określoną przez identyfikator.

Uwagi

Ta funkcja powinna być wywoływana przed odpowiednim DDX_Text wywołaniem funkcji.

Wymagania

Nagłówek afxctl.h

BEGIN_PROPPAGEIDS

Rozpoczyna definicję listy identyfikatorów strony właściwości kontrolki.

BEGIN_PROPPAGEIDS(class_name,  count)

Parametry

class_name
Nazwa klasy kontrolnej, dla której są określane strony właściwości.

count
Liczba stron właściwości używanych przez klasę sterowania.

Uwagi

W pliku implementacji (.cpp), który definiuje funkcje składowe dla klasy, uruchom listę stron właściwości przy użyciu makra BEGIN_PROPPAGEIDS, a następnie dodaj wpisy makra dla każdej strony właściwości i wypełnij listę stron właściwości za pomocą makra END_PROPPAGEIDS.

Aby uzyskać więcej informacji na temat stron właściwości, zobacz artykuł Kontrolki ActiveX: strony właściwości.

Wymagania

Nagłówek afxctl.h

END_PROPPAGEIDS

Kończy definicję listy identyfikatorów strony właściwości.

END_PROPPAGEIDS(class_name)

Parametry

class_name
Nazwa klasy sterującej, która jest właścicielem strony właściwości.

Wymagania

Nagłówek afxctl.h

IDENTYFIKATOR PROPPAGEID

Dodaje stronę właściwości do użycia przez kontrolkę OLE.

PROPPAGEID(clsid)

Parametry

clsid
Unikatowy identyfikator klasy strony właściwości.

Uwagi

Wszystkie makra PROPPAGEID należy umieścić między makrami BEGIN_PROPPAGEIDS i END_PROPPAGEIDS w pliku implementacji kontrolki.

Wymagania

Nagłówek afxctl.h

Zobacz też

Makra i globalne