COleBusyDialog (clase)

Se utiliza en los cuadros de diálogo que indican que el servidor OLE no responde o el servidor está ocupado.

Sintaxis

class COleBusyDialog : public COleDialog

Miembros

Constructores públicos

Nombre	Descripción
COleBusyDialog::COleBusyDialog	Construye un objeto COleBusyDialog.

Métodos públicos

Nombre	Descripción
COleBusyDialog::DoModal	Muestra el cuadro de diálogo Servidor ocupado de OLE.
COleBusyDialog::GetSelectionType	Determina la elección realizada en el cuadro de diálogo.

Miembros de datos públicos

Nombre	Descripción
COleBusyDialog::m_bz	Estructura de tipo OLEUIBUSY que controla el comportamiento del cuadro de diálogo.

Comentarios

Cree un objeto de clase COleBusyDialog cuando quiera llamar a estos cuadros de diálogo. Una vez construido un objeto COleBusyDialog, puede usar la estructura m_bz para inicializar los valores o estados de los controles en el cuadro de diálogo. La estructura m_bz es de tipo OLEUIBUSY. Para más información sobre el uso de esta clase de diálogo, consulte la función miembro DoModal.

Nota:

El código de contenedor generado por el Asistente para aplicaciones usa esta clase.

Para más información, consulte la estructura OLEUIBUSY en Windows SDK.

Para más información sobre los cuadros de diálogo específicos de OLE, consulte el artículo Cuadros de diálogo en OLE.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleBusyDialog

Requisitos

Encabezado: afxodlgs.h

COleBusyDialog::COleBusyDialog

Esta función solo construye un objeto COleBusyDialog.

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

Parámetros

htaskBusy
Identificador de la tarea del servidor que está ocupada.

bNotResponding
Si es TRUE, llama al cuadro de diálogo No responde en lugar del cuadro de diálogo Servidor ocupado. La redacción del cuadro de diálogo No responde es ligeramente diferente a la del cuadro de diálogo Servidor ocupado y el botón Cancelar está deshabilitado.

dwFlags
Marca de creación. Puede contener cero o más de los siguientes valores combinados con el operador OR bit a bit:

• BZ_DISABLECANCELBUTTON deshabilita el botón Cancelar al llamar al cuadro de diálogo.

• BZ_DISABLESWITCHTOBUTTON deshabilita el botón Cambiar a al llamar al cuadro de diálogo.

• BZ_DISABLERETRYBUTTON deshabilita el botón Reintentar al llamar al cuadro de diálogo.

pParentWnd
Apunta al objeto de ventana primaria o propietaria (de tipo CWnd) al que pertenece el objeto de cuadro de diálogo. Si es NULL, la ventana primaria del objeto de cuadro de diálogo se establece en la ventana principal de la aplicación.

Comentarios

Para mostrar el cuadro de diálogo, llame a DoModal.

Para más información, consulte la estructura OLEUIBUSY en Windows SDK.

COleBusyDialog::DoModal

Llame a esta función para mostrar los cuadros de diálogo Servidor ocupado de OLE o El servidor no responde.

virtual INT_PTR DoModal();

Valor devuelto

Estado de finalización del cuadro de diálogo. Uno de los valores siguientes:

• IDOK si el cuadro de diálogo se mostró correctamente.

• IDCANCEL si el usuario canceló el cuadro de diálogo.

• IDABORT si se produjo un error. Si se devuelve IDABORT, llame a la función miembro COleDialog::GetLastError para obtener más información sobre el tipo de error que se produjo. Para ver una lista de posibles errores, consulte la función OleUIBusy en Windows SDK.

Comentarios

Si quiere inicializar los distintos controles de cuadro de diálogo estableciendo miembros de la estructura mbz, debe hacerlo antes de llamar a DoModal, pero después de construir el objeto de cuadro de diálogo.

Si DoModal devuelve IDOK, puede llamar a otras funciones miembro para recuperar la configuración o la información que el usuario especificó en el cuadro de diálogo.

COleBusyDialog::GetSelectionType

Llame a esta función para obtener el tipo de selección elegido por el usuario en el cuadro de diálogo Servidor ocupado.

UINT GetSelectionType() const;

Valor devuelto

Tipo de selección que se realizó.

Comentarios

Los valores de tipo de valor devuelto los especifica el tipo de enumeración Selection declarado en la clase COleBusyDialog.

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

A continuación, se describen brevemente estos valores:

• COleBusyDialog::switchTo: se ha presionado el botón Cambiar a.

• COleBusyDialog::retry se ha presionado el botón Reintentar.

• COleBusyDialog::callUnblocked la llamada para activar el servidor ahora está desbloqueada.

COleBusyDialog::m_bz

Estructura de tipo OLEUIBUSY usada para controlar el comportamiento del cuadro de diálogo Servidor ocupado.

OLEUIBUSY m_bz;

Comentarios

Los miembros de esta estructura se pueden modificar directamente o a través de funciones miembro.

Para más información, consulte la estructura OLEUIBUSY en Windows SDK.

Consulte también

COleDialog (clase)
Gráfico de jerarquías
COleDialog (clase)