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

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

  • Статья

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

Синтаксис

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

Члены

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 . Этот элемент игнорируется, если член 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

См. также раздел

OleUIChangeIcon

OleUIConvert