Структура OLEUIBUSYA (oledlg.h)

Статья
11/20/2024

Содержит сведения, которые библиотека пользовательского интерфейса OLE использует для инициализации диалогового окна занято, а пространство для библиотеки для возврата сведений при закрытии диалогового окна.

Синтаксис

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;

Члены

cbStruct

Размер структуры в байтах. Это поле должно быть заполнено во входных данных.

dwFlags

При входных данных задает флаги инициализации и создания. При выходе он указывает выбор пользователя. Это может быть сочетание следующих флагов.

Ценность	Значение
BZ_DISABLECANCELBUTTON	Этот флаг отключает кнопку Отмена.
BZ_DISABLESWITCHTOBUTTON	Только входные данные. Этот флаг отключает кнопку переключиться на...
BZ_DISABLERETRYBUTTON	Только входные данные. Этот флаг отключает кнопку повтора.
BZ_NOTRESPONDINGDIALOG	Только входные данные. Этот флаг создает диалоговое окно "Не отвечать на" вместо диалогового окна "Занято". Текст немного отличается, и кнопка отмены отключена.

hWndOwner

Окно, владеющее диалоговым окном. Этот элемент не должен быть NULL.

lpszCaption

Указатель на строку, которая будет использоваться в качестве заголовка диалогового окна. Если NULL, библиотека использует Занят.

lpfnHook

Указатель на функцию перехватчика, которая обрабатывает сообщения, предназначенные для диалогового окна. Функция перехватчика должна возвращать ноль, чтобы передать сообщение, которое оно не обрабатывалось обратно в процедуру диалогового окна в библиотеке. Функция перехватчика должна возвращать ненулевое значение, чтобы предотвратить обработку сообщения, которое уже обработано процедурой диалогового окна библиотеки.

lCustData

Определяемые приложением данные, которые библиотека передает функции перехватчика, на которую указывает элемент lpfnHook. Библиотека передает указатель на структуру OLEUIBUSY в параметре lParam сообщения WM_INITDIALOG; этот указатель можно использовать для получения элемента lCustData.

hInstance

Экземпляр, содержащий шаблон диалогового окна, указанный элементом lpTemplateName.

lpszTemplate

Указатель на строку, завершающую значение NULL, которая указывает имя файла ресурса для шаблона диалогового окна, который должен быть заменен шаблоном диалогового окна занятой библиотеки.

hResource

Настраиваемый дескриптор шаблона.

hTask

Только входные данные. Обработайте задачу, которая блокируется.

lphWndDialog

Указатель на HWNDдиалогового окна.

Замечания

Заметка

Заголовок oledlg.h определяет OLEUIBUSY как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	oledlg.h

См. также

OleUIBusy

Поделиться через