Структура OLEUICONVERTW (oledlg.h)
Содержит сведения, которые библиотека пользовательского интерфейса OLE использует для инициализации диалогового окна Преобразование , и пространство для библиотеки для возврата сведений при закрытии диалогового окна.
Синтаксис
typedef struct tagOLEUICONVERTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;
Члены
cbStruct
Размер структуры в байтах. Этот элемент должен быть заполнен на входных данных.
dwFlags
На входных данных в этом поле указываются флаги инициализации и создания. При выходе он задает варианты выбора пользователя. Это может быть сочетание следующих флагов.
hWndOwner
Окно, владеющее диалоговым окном. Этот элемент не должен иметь значение NULL.
lpszCaption
Указатель на строку, используемую в качестве заголовка диалогового окна. Если значение РАВНО NULL, то библиотека использует Convert.
lpfnHook
Указатель на функцию-перехватчик, которая обрабатывает сообщения, предназначенные для диалогового окна. Функция-перехватчик должна возвращать ноль, чтобы передать сообщение, которое она не обработала, в процедуру диалогового окна в библиотеке. Функция-перехватчик должна возвращать ненулевое значение, чтобы предотвратить обработку уже обработанного ею сообщения в диалоговом окне библиотеки.
lCustData
Определяемые приложением данные, которые библиотека передает в функцию-перехватчик, на которую указывает член lpfnHook . Библиотека передает указатель на структуру OLEUICONVERT в параметре lParam WM_INITDIALOG сообщения; этот указатель можно использовать для получения элемента lCustData .
hInstance
Экземпляр, содержащий шаблон диалогового окна, заданный элементом lpszTemplate . Этот элемент игнорируется, если элемент lpszTemplate имеет значение NULL или является недопустимым.
lpszTemplate
Указатель на строку, завершающуюся нулевым значением, которая указывает имя файла ресурсов для шаблона диалогового окна, который должен быть заменен шаблоном диалогового окна «Преобразование » библиотеки.
hResource
Дескриптор ресурса для настраиваемого диалогового окна. Если этот элемент имеет значение NULL, библиотека использует стандартный шаблон диалогового окна "Преобразование " или, если он действителен, шаблон с именем элемента lpszTemplate .
clsid
ИДЕНТИФИКАТОР CLSID объекта для преобразования или активации. Этот элемент задается для входных данных.
clsidConvertDefault
CLSID, используемый в качестве класса по умолчанию при выборе параметра Преобразовать в. Этот элемент игнорируется, если элемент dwFlags не содержит CF_SETCONVERTDEFAULT. Этот элемент задается для входных данных.
clsidActivateDefault
CLSID, используемый в качестве класса по умолчанию при выборе параметра Активировать как . Этот элемент игнорируется, если элемент dwFlags не содержит CF_SETACTIVATEDEFAULT. Этот элемент задается для входных данных.
clsidNew
CLSID выбранного класса. Этот элемент задается в выходных данных.
dvAspect
Аспект объекта . Это должно быть либо DVASPECT_CONTENT, либо DVASPECT_ICON. Если параметр dvAspect DVASPECT_ICON на входных данных, установите флажок Показать как значок и отобразится значок объекта. Этот элемент задается для входных и выходных данных. Дополнительные сведения см. в разделе DVASPECT.
wFormat
Формат данных объекта для преобразования или активации.
fIsLinkedObject
Значение TRUE , если объект связан. Этот элемент задается для входных данных.
hMetaPict
METAFILEPICT, содержащий знаковый аспект. Этот элемент задается для входных и выходных данных.
lpszUserType
Указатель на имя типа пользователя объекта для преобразования или активации. Если это значение равно NULL, диалоговое окно получит имя типа пользователя из реестра. Эта строка освобождается при выходе.
fObjectsIconChanged
Значение TRUE , если значок объекта изменился. (то есть, если oleUIChangeIcon был вызван, а не отменен.) Этот элемент задается в выходных данных.
lpszDefLabel
Указатель на метку по умолчанию, используемую для значка. Если значение РАВНО NULL, будет использоваться короткое имя типа пользователя. Если объект является ссылкой, вызывающий объект должен передать отображаемое имя источника ссылки. Это освобождается при выходе.
cClsidExclude
Количество идентификаторов CLSID в lpClsidExclude.
lpClsidExclude
Указатель на список идентификаторов CLSID, которые необходимо исключить из списка.
Комментарии
Примечание
Заголовок oledlg.h определяет OLEUICONVERT в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | oledlg.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по