Структура 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 | При входе выберите переключатель Current при инициализации. При выходе указывает, что пользователь выбрал Current. |
| CIF_SELECTDEFAULT | При входе выберите переключатель по умолчанию при инициализации. При выходе указывает, что пользователь выбрал по умолчанию. |
| CIF_SELECTFROMFILE | При входе выберите переключатель from File при инициализации. При выходе пользователь выбрал из файла. |
| CIF_USEICONEXE | Только входные данные. Извлекает значок из исполняемого файла, указанного в элементе szIconExe, а не извлекает его из класса. Это полезно для внедрения или связывания OLE-файлов без OLE. |
hWndOwner
Окно, владеющее диалоговым окном. Этот элемент не должен быть NULL.
lpszCaption
Указатель на строку, используемую в качестве заголовка диалогового окна. Если null, библиотека использует значок изменения.
lpfnHook
Указатель на функцию перехватчика, которая обрабатывает сообщения, предназначенные для диалогового окна. Функция перехватчика должна возвращать ноль, чтобы передать сообщение, которое оно не обрабатывалось обратно в процедуру диалогового окна в библиотеке. Функция перехватчика должна возвращать ненулевое значение, чтобы предотвратить обработку сообщения, которое уже обработано процедурой диалогового окна библиотеки.
lCustData
Определяемые приложением данные, которые библиотека передает функции перехватчика, на которую указывает элемент lpfnHook. Библиотека передает указатель на структуру OLEUICHANGEICON в параметре lParam сообщения WM_INITDIALOG; этот указатель можно использовать для получения элемента lCustData.
hInstance
Экземпляр, содержащий шаблон диалогового окна, указанный элементом lpTemplateName.
lpszTemplate
Указатель на строку, завершающую значение NULL, которая указывает имя файла ресурса для шаблона диалогового окна, который должен быть заменен шаблоном диалогового окна диалогового окна библиотеки.
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 |