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

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

  • Статья

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

Синтаксис

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

Члены

cbStruct

Размер структуры в байтах. Это поле должно быть заполнено на входных данных.

dwFlags

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

Значение Значение
IOF_SHOWHELP
 В диалоговом окне появится кнопка Справка .
IOF_SELECTCREATENEW
 Переключатель Создать изначально будет установлен. Его нельзя использовать с IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE
 Изначально будет установлен флажок Создать из файла . Его нельзя использовать с IOF_SELECTCREATENEW.
IOF_CHECKLINK
 Изначально будет установлен флажок Ссылка проверка.
IOF_CHECKDISPLAYASICON
 Изначально будет установлен флажок Отображать как значок проверка, отобразится текущий значок, а кнопка Изменить значок будет включена.
IOF_CREATENEWOBJECT
 Новый объект должен быть создан, когда пользователь нажимает кнопку ОК , чтобы закрыть диалоговое окно и выбран переключатель Создать .
IOF_CREATEFILEOBJECT
 Новый объект должен быть создан из указанного файла, когда пользователь нажимает кнопку ОК , чтобы закрыть диалоговое окно, и выбран переключатель Создать из файла .
IOF_CREATELINKOBJECT
 Новый связанный объект должен быть создан, когда пользователь нажимает кнопку ОК, чтобы закрыть диалоговое окно, а пользователь установите флажок Связать проверка.
IOF_DISABLELINK
 Поле Ссылка проверка будет отключена при инициализации.
IOF_VERIFYSERVERSEXIST
 Диалоговое окно должно проверять классы, добавляемые в поле listbox, гарантируя, что сервер, указанный в базе данных регистрации, существует. Это важный фактор производительности.
IOF_DISABLEDISPLAYASICON
 Поле Отображать как значок проверка будет отключено при инициализации.
IOF_HIDECHANGEICON
 Кнопка Значок изменения будет скрыта в диалоговом окне Вставка объекта .
IOF_SHOWINSERTCONTROL
 Отображает переключатель Вставить элемент управления .
IOF_SELECTCREATECONTROL
 Отображает переключатель Создать элемент управления .

hWndOwner

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

lpszCaption

Указатель на строку, используемую в качестве заголовка диалогового окна. Если значение РАВНО NULL, библиотека использует объект Insert.

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

Настраиваемый дескриптор шаблона.

clsid

CLSID для класса вставляемого объекта. Заполнено в выходных данных.

lpszFile

Указатель на имя файла, который необходимо связать или внедрить. Заполнено в выходных данных.

cchFile

Размер буфера lpszFile ; не превысит MAX_PATH.

cClsidExclude

Количество идентификаторов CLSID, включенных в список lpClsidExclude . Заполнено на входных данных.

lpClsidExclude

Указатель на список идентификаторов CLSID, которые необходимо исключить из списка.

iid

Идентификатор запрошенного интерфейса. Если OleUIInsertObject создает объект , он вернет указатель на этот интерфейс. Этот параметр игнорируется, если OleUIInsertObject не создает объект .

oleRender

Параметр отрисовки. Если OleUIInsertObject создает объект , он выбирает параметр отрисовки при создании объекта . Этот параметр игнорируется, если OleUIInsertObject не создает объект .

lpFormatEtc

Требуемый формат. Если OleUIInsertObject создает объект , он выбирает формат при создании объекта. Этот параметр игнорируется, если OleUIInsertObject не создает объект .

lpIOleClientSite

Указатель на клиентский сайт, используемый для объекта . Этот параметр игнорируется, если OleUIInsertObject не создает объект .

lpIStorage

Указатель на хранилище, используемое для объекта . Этот параметр игнорируется, если OleUIInsertObject не создает объект .

ppvObj

Адрес выходной переменной указателя, содержащей указатель интерфейса для вставляемого объекта. Этот параметр игнорируется, если OleUIInsertObject не создает объект .

sc

Результат создания вызовов. Этот параметр игнорируется, если OleUIInsertObject не создает объект .

hMetaPict

Структура MetafilePict, содержащая знаковый аспект, если он не был помещен в кэш объекта.

Комментарии

Примечание

Заголовок oledlg.h определяет OLEUIINSERTOBJECT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть oledlg.h

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

OleUIInsertObject