COleBusyDialog-Klasse

  • Artikel

Wird für die OLE-Dialogfelder "Server antwortet nicht" oder "Server ausgelastet" verwendet.

Syntax

class COleBusyDialog : public COleDialog

Member

Öffentliche Konstruktoren

Name Beschreibung
COleBusyDialog::COleBusyDialog Erstellt ein COleBusyDialog-Objekt.

Öffentliche Methoden

Name Beschreibung
COleBusyDialog::D oModal Zeigt das Dialogfeld "Ausgelastet" des OLE-Servers an.
COleBusyDialog::GetSelectionType Bestimmt die im Dialogfeld getroffene Auswahl.

Öffentliche Datenmember

Name Beschreibung
COleBusyDialog::m_bz Struktur des Typs OLEUIBUSY, die das Verhalten des Dialogfelds steuert.

Hinweise

Erstellen Sie ein Klassenobjekt COleBusyDialog , wenn Sie diese Dialogfelder aufrufen möchten. Nachdem ein COleBusyDialog Objekt erstellt wurde, können Sie die m_bz Struktur verwenden, um die Werte oder Zustände von Steuerelementen im Dialogfeld zu initialisieren. Die m_bz Struktur ist vom Typ OLEUIBUSY. Weitere Informationen zur Verwendung dieser Dialogklasse finden Sie in der DoModal-Memberfunktion .

Hinweis

Der vom Anwendungs-Assistent generierte Containercode verwendet diese Klasse.

Weitere Informationen finden Sie in der OLEUIBUSY-Struktur im Windows SDK.

Weitere Informationen zu OLE-spezifischen Dialogfeldern finden Sie im Artikel Dialogfelder in OLE.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleBusyDialog

Anforderungen

Kopfzeile: afxodlgs.h

COleBusyDialog::COleBusyDialog

Diese Funktion erstellt nur ein COleBusyDialog Objekt.

explicit COleBusyDialog(
    HTASK htaskBusy,
    BOOL bNotResponding = FALSE,
    DWORD dwFlags = 0,
    CWnd* pParentWnd = NULL);

Parameter

htaskBusy
Behandeln Sie die Serveraufgabe, die ausgelastet ist.

bNotResponding
Wenn WAHR, rufen Sie das Dialogfeld "Nicht antworten" anstelle des Dialogfelds "Server beschäftigt" auf. Der Wortlaut im Dialogfeld "Nicht antworten" unterscheidet sich geringfügig vom Wort im Dialogfeld "Server beschäftigt", und die Schaltfläche "Abbrechen" ist deaktiviert.

dwFlags
Erstellungskennzeichnung. Kann null oder mehr der folgenden Werte enthalten, kombiniert mit dem Bitweise-OR-Operator:

  • BZ_DISABLECANCELBUTTON Schaltfläche "Abbrechen" beim Aufrufen des Dialogfelds deaktivieren.

  • BZ_DISABLESWITCHTOBUTTON Die Umschaltschaltfläche beim Aufrufen des Dialogfelds deaktivieren.

  • BZ_DISABLERETRYBUTTON Die Schaltfläche "Wiederholen" beim Aufrufen des Dialogfelds deaktivieren.

pParentWnd
Verweist auf das übergeordnete oder Besitzerfensterobjekt (vom Typ CWnd), zu dem das Dialogobjekt gehört. Wenn es NULL ist, wird das übergeordnete Fenster des Dialogfeldobjekts auf das Hauptanwendungsfenster festgelegt.

Hinweise

Rufen Sie DoModal auf, um das Dialogfeld anzuzeigen.

Weitere Informationen finden Sie in der OLEUIBUSY-Struktur im Windows SDK.

COleBusyDialog::D oModal

Rufen Sie diese Funktion auf, um das Dialogfeld "Ole Server beschäftigt" oder "Server reagiert nicht" anzuzeigen.

virtual INT_PTR DoModal();

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 zum Typ des aufgetretenen Fehlers zu erhalten. Eine Auflistung möglicher Fehler finden Sie in der OleUIBusy-Funktion im Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeldsteuerelemente initialisieren möchten, indem Sie Elemente der m_bz Struktur festlegen, sollten Sie dies vor dem Aufrufen DoModalausführen, aber nach dem Erstellen des Dialogobjekts.

Wenn DoModal IDOK zurückgegeben wird, können Sie andere Memberfunktionen aufrufen, um die Einstellungen oder Informationen abzurufen, die vom Benutzer in das Dialogfeld eingegeben wurden.

COleBusyDialog::GetSelectionType

Rufen Sie diese Funktion auf, um den vom Benutzer im Dialogfeld "Server beschäftigt" ausgewählten Auswahltyp abzurufen.

UINT GetSelectionType() const;

Rückgabewert

Art der getroffenen Auswahl.

Hinweise

Die Rückgabetypwerte werden durch den Selection in der COleBusyDialog Klasse deklarierten Enumerationstyp angegeben.

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

Kurze Beschreibungen dieser Werte folgen:

  • COleBusyDialog::switchTo Die Umschalttaste wurde gedrückt.

  • COleBusyDialog::retry Die Schaltfläche "Wiederholen" wurde gedrückt.

  • COleBusyDialog::callUnblocked Der Aufruf zum Aktivieren des Servers wird jetzt aufgehoben.

COleBusyDialog::m_bz

Struktur des Typs OLEUIBUSY, die verwendet wird, um das Verhalten des Dialogfelds "Server beschäftigt" zu steuern.

OLEUIBUSY m_bz;

Hinweise

Elemente dieser Struktur können direkt oder über Memberfunktionen geändert werden.

Weitere Informationen finden Sie in der OLEUIBUSY-Struktur im Windows SDK.

Siehe auch

COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse