Condividi tramite

Classe COleBusyDialog

  • Articolo

Utilizzata per la finestra di dialogo relativa al server OLE che non risponde o al server occupato.

Sintassi

class COleBusyDialog : public COleDialog

Membri

Costruttori pubblici

Nome Descrizione
COleBusyDialog::COleBusyDialog Costruisce un oggetto COleBusyDialog.

Metodi pubblici

Nome Descrizione
COleBusyDialog::D oModal Visualizza la finestra di dialogo OLE Server Busy .
COleBusyDialog::GetSelectionType Determina la scelta effettuata nella finestra di dialogo.

Membri dati pubblici

Nome Descrizione
COleBusyDialog::m_bz Struttura di tipo OLEUIBUSY che controlla il comportamento della finestra di dialogo.

Osservazioni:

Creare un oggetto della classe COleBusyDialog quando si desidera chiamare queste finestre di dialogo. Dopo la costruzione di un COleBusyDialog oggetto, è possibile utilizzare la struttura m_bz per inizializzare i valori o gli stati dei controlli nella finestra di dialogo. La m_bz struttura è di tipo OLEUIBUSY. Per altre informazioni sull'uso di questa classe di dialoghi, vedere la funzione membro DoModal .

Nota

Il codice del contenitore generato dalla procedura guidata dell'applicazione usa questa classe.

Per altre informazioni, vedere la struttura OLEUIBUSY in Windows SDK.

Per altre informazioni sulle finestre di dialogo specifiche di OLE, vedere l'articolo Finestre di dialogo in OLE.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleBusyDialog

Requisiti

Intestazione: afxodlgs.h

COleBusyDialog::COleBusyDialog

Questa funzione costruisce solo un COleBusyDialog oggetto .

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

Parametri

htaskBusy
Handle per l'attività server occupata.

bNotResponding
Se TRUE, chiamare la finestra di dialogo Non risponde anziché la finestra di dialogo Server Occupato. La formulazione nella finestra di dialogo Non risponde è leggermente diversa dalla formulazione nella finestra di dialogo Server Occupato e il pulsante Annulla è disabilitato.

dwFlags
Flag di creazione. Può contenere zero o più dei valori seguenti combinati con l'operatore OR bit per bit:

  • BZ_DISABLECANCELBUTTON Disabilitare il pulsante Annulla quando si chiama la finestra di dialogo.

  • BZ_DISABLESWITCHTOBUTTON Disabilitare il pulsante Passa a quando si chiama la finestra di dialogo.

  • BZ_DISABLERETRYBUTTON Disabilitare il pulsante Riprova quando si chiama la finestra di dialogo.

pParentWnd
Punta all'oggetto finestra padre o proprietario (di tipo CWnd) a cui appartiene l'oggetto finestra di dialogo. Se è NULL, la finestra padre dell'oggetto finestra di dialogo viene impostata sulla finestra principale dell'applicazione.

Osservazioni:

Per visualizzare la finestra di dialogo, chiamare DoModal.

Per altre informazioni, vedere la struttura OLEUIBUSY in Windows SDK.

COleBusyDialog::D oModal

Chiamare questa funzione per visualizzare la finestra di dialogo OLE Server Busy o Server Not Responding .

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 COleDialog::GetLastError funzione membro per ottenere altre informazioni sul tipo di errore che si è verificato. Per un elenco dei possibili errori, vedere la funzione OleUIBusy in Windows SDK.

Osservazioni:

Se si desidera inizializzare i vari controlli della finestra di dialogo impostando i membri della struttura m_bz , è necessario eseguire questa operazione prima di chiamare DoModal, ma dopo la costruzione dell'oggetto dialogo.

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

COleBusyDialog::GetSelectionType

Chiamare questa funzione per ottenere il tipo di selezione scelto dall'utente nella finestra di dialogo Server Occupato.

UINT GetSelectionType() const;

Valore restituito

Tipo di selezione effettuata.

Osservazioni:

I valori del tipo restituito vengono specificati dal Selection tipo di enumerazione dichiarato nella COleBusyDialog classe .

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

Di seguito sono riportate brevi descrizioni di questi valori:

  • COleBusyDialog::switchTo Il pulsante Passa a è stato premuto.

  • COleBusyDialog::retry È stato premuto il pulsante Riprova.

  • COleBusyDialog::callUnblocked La chiamata per attivare il server è ora sbloccata.

COleBusyDialog::m_bz

Struttura di tipo OLEUIBUSY utilizzata per controllare il comportamento della finestra di dialogo Server occupato.

OLEUIBUSY m_bz;

Osservazioni:

I membri di questa struttura possono essere modificati direttamente o tramite funzioni membro.

Per altre informazioni, vedere la struttura OLEUIBUSY in Windows SDK.

Vedi anche

Classe COleDialog
Grafico della gerarchia
Classe COleDialog