Partilhar via

Classe COleBusyDialog

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Usado para as caixas de diálogo OLE Server Not Responding ou Server Busy (Servidor Ocupado).

Sintaxe

class COleBusyDialog : public COleDialog

Membros

Construtores Públicos

Nome Description
COleBusyDialog::COleBusyDialog Constrói um COleBusyDialog objeto.

Métodos Públicos

Nome Description
COleBusyDialog::D oModal Mostra a caixa de diálogo Ocupado do Servidor OLE.
COleBusyDialog::GetSelectionType Determina a escolha feita na caixa de diálogo.

Membros de Dados Públicos

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

Observações

Cria um objeto de classe COleBusyDialog quando quiseres chamar estas caixas de diálogo. Depois de um COleBusyDialog objeto ter sido construído, pode usar a estrutura m_bz para inicializar os valores ou estados dos controlos na caixa de diálogo. A m_bz estrutura é do tipo OLEUIBUSY. Para mais informações sobre a utilização desta classe de diálogo, consulte a função membro DoModal .

Observação

O código de contentor gerado pelo Assistente de Aplicação utiliza esta classe.

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

Para mais informações sobre caixas de diálogo específicas para OLE, consulte o artigo Caixas de Diálogo em OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleBusyDialog

Requerimentos

Cabeçalho: afxodlgs.h

COleBusyDialog::COleBusyDialog

Esta função apenas constrói um COleBusyDialog objeto.

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

Parâmetros

htaskBusy
Tratar da tarefa do servidor que está ocupada.

bNãoA Responder
Se for 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 da caixa de diálogo Servidor Ocupado, e o botão Cancelar está desativado.

dwBandeiras
Bandeira de criação. Pode conter zero ou mais dos seguintes valores combinados com o operador bitwise-OR:

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

  • BZ_DISABLESWITCHTOBUTTON Desativar o botão Mudar Para ao chamar a caixa de diálogo.

  • BZ_DISABLERETRYBUTTON desativar o botão Retry ao chamar a caixa de diálogo.

pParentWnd
Aponta para o objeto janela pai ou proprietário (do tipo CWnd) ao qual pertence o objeto de diálogo. Se for NULL, a janela pai do objeto de diálogo é definida como a janela principal da aplicação.

Observações

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

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

COleBusyDialog::D oModal

Chame esta função para mostrar a caixa de diálogo OLE Server Busy ou Server Not Responding.

virtual INT_PTR DoModal();

Valor de retorno

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

  • Não sei se a caixa de diálogo foi exibida com sucesso.

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

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

Observações

Se quiseres inicializar os vários controlos das caixas de diálogo definindo membros da estrutura m_bz , deves fazer isto antes de chamar DoModal, mas depois de o objeto de diálogo estar construído.

Se DoModal devolver IDOK, pode chamar outras funções membros para recuperar as definições ou informações introduzidas pelo utilizador na caixa de diálogo.

COleBusyDialog::GetSelectionType

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

UINT GetSelectionType() const;

Valor de retorno

Tipo de seleção feita.

Observações

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

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

Seguem-se breves descrições destes valores:

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

  • COleBusyDialog::retry O botão de retentar foi pressionado.

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

COleBusyDialog::m_bz

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

OLEUIBUSY m_bz;

Observações

Os membros desta estrutura podem ser modificados diretamente ou através de funções membro.

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

Consulte também

Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog

  • Last updated on