Pagine delle proprietà (MFC)

Le pagine delle proprietà visualizzano i valori correnti di proprietà specifiche del controllo OLE in un'interfaccia grafica personalizzabile per la visualizzazione e la modifica supportando un meccanismo di mapping dei dati basato sullo scambio di dati della finestra di dialogo (DDX).

Questo meccanismo di mapping dei dati esegue il mapping dei controlli delle pagine delle proprietà alle singole proprietà del controllo OLE. Il valore della proprietà del controllo riflette lo stato o il contenuto del controllo pagina delle proprietà. Il mapping tra i controlli della pagina delle proprietà e le proprietà viene specificato da DDP_ chiamate di funzione nella funzione membro della pagina delle DoDataExchange proprietà. Di seguito è riportato un elenco di funzioni di DDP_ che scambiano i dati immessi usando la pagina delle proprietà del controllo:

Trasferimento dei dati della pagina delle proprietà

Nome	Descrizione
DDP_CBIndex	Collega l'indice della stringa selezionata in una casella combinata con la proprietà di un controllo.
DDP_CBString	Collega la stringa selezionata in una casella combinata con la proprietà di un controllo. La stringa selezionata può iniziare con le stesse lettere del valore della proprietà, ma non deve corrispondere completamente.
DDP_CBStringExact	Collega la stringa selezionata in una casella combinata con la proprietà di un controllo. La stringa selezionata e il valore stringa della proprietà devono corrispondere esattamente.
DDP_Check	Collega una casella di controllo nella pagina delle proprietà del controllo con la proprietà di un controllo.
DDP_LBIndex	Collega l'indice della stringa selezionata in una casella di riepilogo con la proprietà di un controllo.
DDP_LBString	Collega la stringa selezionata in una casella di riepilogo con la proprietà di un controllo. La stringa selezionata può iniziare con le stesse lettere del valore della proprietà, ma non deve corrispondere completamente.
DDP_LBStringExact	Collega la stringa selezionata in una casella di riepilogo con la proprietà di un controllo. La stringa selezionata e il valore stringa della proprietà devono corrispondere esattamente.
DDP_PostProcessing	Completa il trasferimento dei valori delle proprietà dal controllo.
DDP_Radio	Collega un gruppo di pulsanti di opzione nella pagina delle proprietà del controllo con la proprietà di un controllo.
DDP_Text	Collega un controllo nella pagina delle proprietà del controllo con la proprietà di un controllo. Questa funzione gestisce diversi tipi di proprietà, ad esempio double, , shortBSTR e long.

Per altre informazioni sulle pagine delle funzioni e delle DoDataExchange proprietà, vedere l'articolo Controlli ActiveX: Pagine delle proprietà.

Di seguito è riportato un elenco di macro utilizzate per creare e gestire le pagine delle proprietà per un controllo OLE:

pagine delle proprietà

Nome	Descrizione
BEGIN_PROPPAGEIDS	Inizia l'elenco di ID pagina delle proprietà.
END_PROPPAGEIDS	Termina l'elenco di ID pagina delle proprietà.
PROPPAGEID	Dichiara una pagina delle proprietà della classe del controllo.

DDP_CBIndex

Chiamare questa funzione nella funzione DoDataExchange della pagina delle proprietà per sincronizzare il valore di una proprietà integer con l'indice della selezione corrente di una casella combinata nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella combinata associata alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con il controllo casella combinata specificato da ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_CBIndex.

Requisiti

Intestazione afxctl.h

DDP_CBString

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore di una proprietà stringa con la selezione corrente in una casella combinata nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella combinata associata alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con la stringa della casella combinata specificata da ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_CBString.

Requisiti

Intestazione afxctl.h

DDP_CBStringExact

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore di una proprietà stringa che corrisponde esattamente alla selezione corrente in una casella combinata nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella combinata associata alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con la stringa della casella combinata specificata da ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_CBStringExact.

Requisiti

Intestazione afxctl.h

DDP_Check

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore della proprietà con il controllo casella di controllo della pagina delle proprietà associata.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella di controllo associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con il controllo casella di controllo specificato da ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_Check.

Requisiti

Intestazione afxctl.h

DDP_LBIndex

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore di una proprietà integer con l'indice della selezione corrente in una casella di riepilogo nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella di riepilogo associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con la stringa della casella di riepilogo specificata dall'ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_LBIndex.

Requisiti

Intestazione afxctl.h

DDP_LBString

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore di una proprietà stringa con la selezione corrente in una casella di riepilogo nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella di riepilogo associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con la stringa della casella di riepilogo specificata dall'ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_LBString.

Requisiti

Intestazione afxctl.h

DDP_LBStringExact

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per sincronizzare il valore di una proprietà stringa che corrisponde esattamente alla selezione corrente in una casella di riepilogo nella pagina delle proprietà.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo casella di riepilogo associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con la stringa della casella di riepilogo specificata dall'ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_LBStringExact.

Requisiti

Intestazione afxctl.h

DDP_PostProcessing

Chiamare questa funzione nella funzione della pagina delle DoDataExchange proprietà per completare il trasferimento dei valori delle proprietà dalla pagina delle proprietà al controllo quando vengono salvati i valori delle proprietà.

void AFXAPI DDP_PostProcessing(CDataExchange * pDX);

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

Osservazioni:

Questa funzione deve essere chiamata dopo il completamento di tutte le funzioni di scambio dati. Ad esempio:

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

Requisiti

Intestazione afxctl.h

DDP_Radio

Chiamare questa funzione nella funzione del DoPropExchange controllo per sincronizzare il valore della proprietà con il controllo pulsante di opzione della pagina delle proprietà associato.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo pulsante di opzione associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con il controllo pulsante di opzione specificato da ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_Radio.

Requisiti

Intestazione afxctl.h

DDP_Text

Chiamare questa funzione nella funzione del DoDataExchange controllo per sincronizzare il valore della proprietà con il controllo pagina delle proprietà associato.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

id
ID risorsa del controllo associato alla proprietà del controllo specificata da pszPropName.

membro
Variabile membro associata al controllo pagina delle proprietà specificato dall'ID e dalla proprietà specificata da pszPropName.

pszPropName
Nome della proprietà del controllo da scambiare con il controllo specificato dall'ID.

Osservazioni:

Questa funzione deve essere chiamata prima della corrispondente chiamata di funzione DDX_Text.

Requisiti

Intestazione afxctl.h

BEGIN_PROPPAGEIDS

Inizia la definizione dell'elenco di ID pagina delle proprietà del controllo.

BEGIN_PROPPAGEIDS(class_name,  count)

Parametri

class_name
Nome della classe del controllo per cui vengono specificate le pagine delle proprietà.

count
Numero di pagine delle proprietà utilizzate dalla classe del controllo.

Osservazioni:

Nel file di implementazione (.cpp) che definisce le funzioni membro per la classe, avviare l'elenco delle pagine delle proprietà con la macro BEGIN_PROPPAGEIDS, quindi aggiungere voci di macro per ognuna delle pagine delle proprietà e completare l'elenco delle pagine delle proprietà con la macro END_PROPPAGEIDS.

Per altre informazioni sulle pagine delle proprietà, vedere l'articolo Controlli ActiveX: Pagine delle proprietà.

Requisiti

Intestazione afxctl.h

END_PROPPAGEIDS

Termina la definizione dell'elenco di ID pagina delle proprietà.

END_PROPPAGEIDS(class_name)

Parametri

class_name
Nome della classe di controllo proprietaria della pagina delle proprietà.

Requisiti

Intestazione afxctl.h

PROPPAGEID

Aggiunge una pagina delle proprietà da utilizzare dal controllo OLE.

PROPPAGEID(clsid)

Parametri

clsid
ID classe univoco di una pagina delle proprietà.

Osservazioni:

Tutte le macro PROPPAGEID devono essere posizionate tra le macro BEGIN_PROPPAGEIDS e END_PROPPAGEIDS nel file di implementazione del controllo.

Requisiti

Intestazione afxctl.h

Vedi anche

Macro e globali