Classe COleChangeSourceDialog
Utilizzato per la finestra di dialogo di modifica dell'origine OLE.
Sintassi
class COleChangeSourceDialog : public COleDialog
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| COleChangeSourceDialog::COleChangeSourceDialog | Costruisce un oggetto COleChangeSourceDialog. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| COleChangeSourceDialog::D oModal | Visualizza la finestra di dialogo Origine modifiche OLE. |
| COleChangeSourceDialog::GetDisplayName | Ottiene il nome visualizzato di origine completo. |
| COleChangeSourceDialog::GetFileName | Ottiene il nome del file dal nome dell'origine. |
| COleChangeSourceDialog::GetFromPrefix | Ottiene il prefisso dell'origine precedente. |
| COleChangeSourceDialog::GetItemName | Ottiene il nome dell'elemento dal nome dell'origine. |
| COleChangeSourceDialog::GetToPrefix | Ottiene il prefisso della nuova origine |
| COleChangeSourceDialog::IsValidSource | Indica se l'origine è valida. |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| COleChangeSourceDialog::m_cs | Struttura che controlla il comportamento della finestra di dialogo. |
Osservazioni:
Creare un oggetto della classe COleChangeSourceDialog quando si desidera chiamare questa finestra di dialogo. Dopo aver costruito un COleChangeSourceDialog oggetto, è possibile utilizzare la struttura m_cs per inizializzare i valori o gli stati dei controlli nella finestra di dialogo. La m_cs struttura è di tipo OLEUICHANGESOURCE. Per altre informazioni sull'uso di questa classe di dialoghi, vedere la funzione membro DoModal .
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE in Windows SDK.
Per altre informazioni sulle finestre di dialogo specifiche di OLE, vedere l'articolo Finestre di dialogo in OLE.
Gerarchia di ereditarietà
COleChangeSourceDialog
Requisiti
Intestazione: afxodlgs.h
COleChangeSourceDialog::COleChangeSourceDialog
Questa funzione costruisce un COleChangeSourceDialog oggetto .
explicit COleChangeSourceDialog(
COleClientItem* pItem,
CWnd* pParentWnd = NULL);
Parametri
pItem
Puntatore all'oggetto COleClientItem collegato la cui origine deve essere aggiornata.
pParentWnd
Punta all'oggetto finestra padre o proprietario (di tipo CWnd) a cui appartiene l'oggetto finestra di dialogo. Se è NULL, la finestra padre della finestra di dialogo verrà impostata sulla finestra principale dell'applicazione.
Osservazioni:
Per visualizzare la finestra di dialogo, chiamare la funzione DoModal .
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE e la funzione OleUIChangeSource in Windows SDK.
COleChangeSourceDialog::D oModal
Chiamare questa funzione per visualizzare la finestra di dialogo Origine modifiche OLE.
virtual INT_PTR DoModal();
Valore restituito
Stato di completamento per la finestra di dialogo. Uno dei valori seguenti:
IDOK se la finestra di dialogo è stata visualizzata correttamente.
IDCANCEL se l'utente ha annullato la finestra di dialogo.
IDABORT se si è verificato un errore. Se viene restituito IDABORT, chiamare la funzione membro COleDialog::GetLastError per ottenere altre informazioni sul tipo di errore che si è verificato. Per un elenco dei possibili errori, vedere la funzione OleUIChangeSource in Windows SDK.
Osservazioni:
Se si desidera inizializzare i vari controlli della finestra di dialogo impostando i membri della struttura m_cs , è necessario eseguire questa operazione prima di chiamare DoModal, ma dopo la costruzione dell'oggetto finestra di dialogo.
Se DoModal restituisce IDOK, è possibile chiamare le funzioni membro per recuperare le impostazioni o le informazioni immesse dall'utente dalla finestra di dialogo. I nomi di query tipici sono i nomi di elenco seguenti:
COleChangeSourceDialog::GetDisplayName
Chiamare questa funzione per recuperare il nome visualizzato completo per l'elemento client collegato.
CString GetDisplayName();
Valore restituito
Nome visualizzato di origine completo (moniker) per L'oggetto COleClientItem specificato nel costruttore.
COleChangeSourceDialog::GetFileName
Chiamare questa funzione per recuperare la parte del moniker del file del nome visualizzato per l'elemento client collegato.
CString GetFileName();
Valore restituito
Parte del moniker di file del nome visualizzato di origine per L'oggetto COleClientItem specificato nel costruttore.
Osservazioni:
Il moniker del file insieme al moniker dell'elemento fornisce il nome visualizzato completo.
COleChangeSourceDialog::GetFromPrefix
Chiamare questa funzione per ottenere la stringa di prefisso precedente per l'origine.
CString GetFromPrefix();
Valore restituito
Stringa di prefisso precedente dell'origine.
Osservazioni:
Chiamare questa funzione solo dopo che DoModal restituisce IDOK.
Questo valore proviene direttamente dal lpszFrom membro della struttura OLEUICHANGESOURCE .
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE in Windows SDK.
COleChangeSourceDialog::GetItemName
Chiamare questa funzione per recuperare la parte del moniker dell'elemento del nome visualizzato per l'elemento client collegato.
CString GetItemName();
Valore restituito
Parte del moniker dell'elemento del nome visualizzato di origine per L'oggetto COleClientItem specificato nel costruttore.
Osservazioni:
Il moniker del file insieme al moniker dell'elemento fornisce il nome visualizzato completo.
COleChangeSourceDialog::GetToPrefix
Chiamare questa funzione per ottenere la nuova stringa di prefisso per l'origine.
CString GetToPrefix();
Valore restituito
Nuova stringa di prefisso dell'origine.
Osservazioni:
Chiamare questa funzione solo dopo che DoModal restituisce IDOK.
Questo valore proviene direttamente dal lpszTo membro della struttura OLEUICHANGESOURCE .
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE in Windows SDK.
COleChangeSourceDialog::m_cs
Questo membro dati è una struttura di tipo OLEUICHANGESOURCE.
OLEUICHANGESOURCE m_cs;
Osservazioni:
OLEUICHANGESOURCE viene utilizzato per controllare il comportamento della finestra di dialogo Origine modifiche OLE. I membri di questa struttura possono essere modificati direttamente.
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE in Windows SDK.
COleChangeSourceDialog::IsValidSource
Chiamare questa funzione per determinare se la nuova origine è valida.
BOOL IsValidSource();
Valore restituito
Diverso da zero se la nuova origine è valida, in caso contrario 0.
Osservazioni:
Chiamare questa funzione solo dopo che DoModal restituisce IDOK.
Per altre informazioni, vedere la struttura OLEUICHANGESOURCE in Windows SDK.