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

Статья
11/20/2024

Содержит сведения о том, что библиотека пользовательского интерфейса 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

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

Ценность	Значение
CF_SHOWHELPBUTTON	В диалоговом окне отобразится кнопка справки. Этот флаг установлен для входных данных.
CF_SETCONVERTDEFAULT	Класс, clSID которого указан clsidConvertDefault будет использоваться в качестве выбора по умолчанию. Этот выбор отображается в списке классов, когда выбрана переключатель Преобразование в. Этот флаг установлен для входных данных.
CF_SETACTIVATEDEFAULT	Класс, clSID которого задается clsidActivateDefault будет использоваться в качестве выбора по умолчанию. Этот выбор отображается в списке классов при выборе переключателя активации как. Этот флаг установлен для входных данных.
CF_SELECTCONVERTTO	При входных данных этот флаг указывает, что изначально выбрано преобразование в (поведение по умолчанию). Этот флаг установлен в выходных данных, если преобразовать в был выбран, когда пользователь отклонил диалоговое окно.
CF_SELECTACTIVATEAS	При входе этот флаг указывает, что активировать как изначально выбран. Этот флаг установлен в выходных данных, если активировать как был выбран, когда пользователь отклонил диалоговое окно.
CF_DISABLEDISPLAYASICON	Кнопка отображать как значок будет отключена при инициализации.
CF_DISABLEACTIVATEAS	Переключатель активировать как будет отключен при инициализации.
CF_HIDECHANGEICON	Кнопка "Изменить значок " будет скрыта в диалоговом окне Преобразования.
CF_CONVERTONLY	Переключатель активации от имени будет отключен в диалоговом окне Преобразования.

hWndOwner

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

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	oledlg.h

См. также

OleUIChangeIcon

OleUIConvert

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