Структура 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 |