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 (con estensione 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per