Estrutura OLEUIBUSYA (oledlg.h)

Artigo
11/20/2024

Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Ocupado e espaço para a biblioteca retornar informações quando a caixa de diálogo for descartada.

Sintaxe

typedef struct tagOLEUIBUSYA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  HTASK         hTask;
  HWND          *lphWndDialog;
} OLEUIBUSYA, *POLEUIBUSYA, *LPOLEUIBUSYA;

Membros

cbStruct

O tamanho da estrutura, em bytes. Esse campo deve ser preenchido na entrada.

dwFlags

Na entrada, especifica os sinalizadores de inicialização e criação. Na saída, ele especifica as opções do usuário. Pode ser uma combinação dos sinalizadores a seguir.

Valor	Significado
BZ_DISABLECANCELBUTTON	Esse sinalizador desabilita o botão Cancelar.
BZ_DISABLESWITCHTOBUTTON	Somente entrada. Esse sinalizador desabilita o botão Alternar para....
BZ_DISABLERETRYBUTTON	Somente entrada. Esse sinalizador desabilita o botão de Repetição .
BZ_NOTRESPONDINGDIALOG	Somente entrada. Esse sinalizador gera uma caixa de diálogo Não Responder em vez de uma caixa de diálogo Ocupado. O texto é ligeiramente diferente e o botão Cancelar está desabilitado.

hWndOwner

A janela que possui a caixa de diálogo. Esse membro não deve ser NULL.

lpszCaption

Um ponteiro para uma cadeia de caracteres a ser usada como o título da caixa de diálogo. Se NULL, a biblioteca usará Busy.

lpfnHook

Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função de gancho deve retornar zero para passar uma mensagem informando que ela não foi processada novamente para o procedimento da caixa de diálogo na biblioteca. A função de gancho deve retornar um valor diferente de zero para impedir que o procedimento da caixa de diálogo da biblioteca processe uma mensagem que já foi processada.

lCustData

Dados definidos pelo aplicativo que a biblioteca passa para a função de gancho apontada pelo membro lpfnHook. A biblioteca passa um ponteiro para a estrutura de OLEUIBUSY no parâmetro lParam da mensagem WM_INITDIALOG; esse ponteiro pode ser usado para recuperar o membro lCustData.

hInstance

Instância que contém um modelo de caixa de diálogo especificado pelo membro lpTemplateName.

lpszTemplate

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo de recurso para o modelo da caixa de diálogo que deve ser substituído pelo modelo da caixa de diálogo Ocupado da biblioteca.

hResource

Identificador de modelo personalizado.

hTask

Somente entrada. Manipule para a tarefa que está bloqueando.

lphWndDialog

Ponteiro para o HWND da caixa de diálogo.

Observações

Nota

O cabeçalho oledlg.h define OLEUIBUSY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	oledlg.h

Consulte também

OleUIBusy

Compartilhar via