COleInsertDialog::DoModal

Artikel
06/10/2015

Rufen Sie diese Funktion auf, um das Objektdialogfeld OLE INSERT anzuzeigen.

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

Parameter

dwFlags
Einer der folgenden Werte:

COleInsertDialog::DocObjectsOnly wird nur DocObjects ein.

COleInsertDialog::ControlsOnly fügt nur ActiveX-Steuerelemente ein.

Null wird weder ein DocObject noch ein ActiveX-Steuerelement ein. Dieser Wert ergibt die gleiche - Implementierung, die der erste Prototyp oben aufgelistet ist.

Rückgabewert

Abschlussstatus für das Dialogfeld. Einer der folgenden Werte:

IDOK, wenn das Dialogfeld erfolgreich angezeigt wurde.
IDCANCEL, wenn der Benutzer das Dialogfeld abgebrochen hat.
IDABORT, wenn ein Fehler aufgetreten ist. Wenn IDABORT zurückgegeben wird, rufen Sie die COleDialog::GetLastError-Memberfunktion auf, um weitere Informationen zu den Fehlertyp abzurufen, der aufgetreten ist. Eine Liste der möglichen Fehlern, finden Sie die OleUIInsertObject-Funktion in Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeld-Steuerelemente initialisieren möchten, indem Sie Member der Struktur m_io festlegen, sollten Sie dies tun, bevor Sie DoModal, aber aufrufen, nachdem das gleichzeitig mit ist.

Wenn DoModal IDOK zurückgibt, können Sie andere Memberfunktionen aufrufen, um die Einstellungen oder die Informationseingabe in das Dialogfeld durch Benutzer abzurufen.