Partilhar via

Classe COleBusyDialog

  • Artigo

Usado para as caixas de diálogo Servidor OLE Não Respondendo ou Servidor Ocupado.

Sintaxe

class COleBusyDialog : public COleDialog

Membros

Construtores públicos

Nome Descrição
COleBusyDialog::COleBusyDialog Constrói um objeto COleBusyDialog.

Métodos públicos

Nome Descrição
COleBusyDialog::DoModal Exibe a caixa de diálogo Servidor OLE Ocupado.
COleBusyDialog::GetSelectionType Determina a escolha feita na caixa de diálogo.

Membros de Dados Públicos

Nome Descrição
COleBusyDialog::m_bz Estrutura do tipo OLEUIBUSY que controla o comportamento da caixa de diálogo.

Comentários

Crie um objeto da classe COleBusyDialog quando quiser chamar essas caixas de diálogo. Depois que um objeto COleBusyDialog for construído, você poderá usar a estrutura m_bz para inicializar os valores ou estados dos controles na caixa de diálogo. A estrutura m_bz é do tipo OLEUIBUSY. Para mais informações sobre como usar essa classe de diálogo, confira a função membro DoModal.

Observação

O código de contêiner gerado pelo Assistente de Aplicativo usa essa classe.

Para mais informações, confira a estrutura OLEUIBUSY no SDK do Windows.

Para mais informações sobre caixas de diálogo específicas do OLE, confira o artigo Caixas de diálogo no OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleBusyDialog

Requisitos

Cabeçalho: afxodlgs.h

COleBusyDialog::COleBusyDialog

Essa função só constrói um objeto COleBusyDialog.

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

Parâmetros

htaskBusy
Manipule para a tarefa do servidor que está ocupada.

bNotResponding
Se TRUE, chame a caixa de diálogo Não Responder, em vez da caixa de diálogo Servidor Ocupado. A redação na caixa de diálogo Não Responder é ligeiramente diferente da redação na caixa de diálogo Servidor Ocupado e o botão Cancelar está desabilitado.

dwFlags
Sinalizador de criação. Pode conter zero ou mais dos seguintes valores combinados com o operador bit a bit OR:

  • BZ_DISABLECANCELBUTTON Desabilitar o botão Cancelar ao chamar a caixa de diálogo.

  • BZ_DISABLESWITCHTOBUTTON Desabilitar o botão Alternar para ao chamar a caixa de diálogo.

  • BZ_DISABLERETRYBUTTON Desabilitar o botão Repetir ao chamar a caixa de diálogo.

pParentWnd
Aponta para o objeto de janela pai ou proprietário (do tipo CWnd) ao qual o objeto de caixa de diálogo pertence. Se for NULL, a janela pai do objeto de caixa de diálogo será definida como a janela principal do aplicativo.

Comentários

Para exibir a caixa de diálogo, chame DoModal.

Para mais informações, confira a estrutura OLEUIBUSY no SDK do Windows.

COleBusyDialog::DoModal

Chame essa função para exibir a caixa de diálogo Servidor OLE Ocupado ou Servidor Não Responde.

virtual INT_PTR DoModal();

Valor de retorno

Status de conclusão da caixa de diálogo. Um dos seguintes valores:

  • IDOK se a caixa de diálogo foi exibida com êxito.

  • IDCANCEL se o usuário cancelou a caixa de diálogo.

  • IDABORT se ocorreu um erro. Se IDABORT for retornado, chame a função de membro COleDialog::GetLastError para obter mais informações sobre o tipo de erro que ocorreu. Para uma lista de possíveis erros, confira a função OleUIBusy no SDK do Windows.

Comentários

Se você quiser inicializar os vários controles da caixa de diálogo definindo membros da estrutura m_bz, faça isso antes de chamar DoModal, mas depois que o objeto de caixa de diálogo for construído.

Se retornar DoModal, você poderá chamar outras funções membro para recuperar as configurações ou informações inseridas pelo usuário na caixa de diálogo.

COleBusyDialog::GetSelectionType

Chame essa função para obter o tipo de seleção escolhido pelo usuário na caixa de diálogo Servidor Ocupado.

UINT GetSelectionType() const;

Valor de retorno

Tipo de seleção feita.

Comentários

Os valores de tipo retornado são especificados pelo tipo de enumeração Selection declarado na classe COleBusyDialog.

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

Breves descrições desses valores estão a seguir:

  • COleBusyDialog::switchTo O botão Alternar para foi pressionado.

  • COleBusyDialog::retry O botão Repetir foi pressionado.

  • COleBusyDialog::callUnblocked A chamada para ativar o servidor agora está desbloqueada.

COleBusyDialog::m_bz

Estrutura do tipo OLEUIBUSY usada para controlar o comportamento da caixa de diálogo Servidor Ocupado.

OLEUIBUSY m_bz;

Comentários

Os membros dessa estrutura podem ser modificados diretamente ou por meio de funções de membro.

Para mais informações, confira a estrutura OLEUIBUSY no SDK do Windows.

Confira também

Classe COleDialog
Gráfico da hierarquia
Classe COleDialog