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

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

Синтаксис

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

Члены

cbStruct

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

dwFlags

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

Значение	Значение
CIF_SHOWHELP	В диалоговом окне отображается кнопка Справка .
CIF_SELECTCURRENT	На входных данных выбирает переключатель Текущий при инициализации. При выходе указывает, что пользователь выбрал текущий.
CIF_SELECTDEFAULT	При входе выбирает переключатель По умолчанию при инициализации. При выходе указывает, что пользователь выбрал значение По умолчанию.
CIF_SELECTFROMFILE	При входе выбирает переключатель Из файла при инициализации. При выходе указывает, что пользователь выбрал из файла.
CIF_USEICONEXE	Только входные данные. Извлекает значок из исполняемого файла, указанного в члене szIconExe , а не извлекает его из класса . Это полезно для внедрения OLE-файлов или связывания с файлами, не являющихся OLE.

hWndOwner

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

lpszCaption

Указатель на строку, используемую в качестве заголовка диалогового окна. Если значение РАВНО NULL, библиотека использует значок изменения.

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

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

hMetaPict

Текущее и окончательное изображение. Источник значка внедряется в сам метафайл.

clsid

Только входные данные. Класс, используемый для получения значка по умолчанию .

szIconExe[MAX_PATH]

Только входные данные. Указатель на исполняемый файл для извлечения значка по умолчанию. Этот член игнорируется, если CIF_USEICONEXE не включен в член dwFlags и попытка получить значок класса из указанного ИДЕНТИФИКАТОРА CLSID завершается ошибкой.

cchIconExe

Только входные данные. Количество символов в szIconExe. Этот элемент игнорируется, если CIF_USEICONEXE не включен в элемент dwFlags .

Комментарии

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Верхняя часть	oledlg.h