COleInsertDialog::DoModal

Articolo
02/19/2013

Chiamare la funzione per visualizzare la finestra di dialogo dell'oggetto di inserimento di OLE.

virtual INT_PTR 
   DoModal();
INT_PTR 
   DoModal(
   DWORD dwFlags 
);

Parametri

dwFlags
Uno dei valori seguenti:

COleInsertDialog::DocObjectsOnly inserisce solo DocObjects.

COleInsertDialog::ControlsOnly inserisce solo i controlli ActiveX.

Inserisce zero né un DocObject né un controllo ActiveX.Questo valore viene utilizzato nella stessa implementazione del primo prototipo indicato in precedenza.

Valore restituito

Lo stato di completamento della finestra di dialogo.Uno dei valori seguenti:

IDOK se la finestra di dialogo visualizzare correttamente.
IDCANCEL se l'utente annullasse la finestra di dialogo.
IDABORT se si è verificato un errore.Se IDABORT viene restituito, chiamare la funzione membro COleDialog::GetLastError per ottenere ulteriori informazioni sul tipo di errore che si è verificato.Per un elenco di errori possibili, vedere la funzione OleUIInsertObject in Windows SDK.

Note

Se si desidera inizializzare i controlli della finestra di dialogo impostare i membri della struttura m_io, è necessario eseguire questa operazione prima di chiamare DoModal, ma dopo che l'oggetto finestra di dialogo.

Se DoModal restituisce IDOK, è possibile chiamare le funzioni membro per recuperare le impostazioni o l'input di informazioni nella finestra di dialogo dall'utente.