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

Статья
11/20/2024

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

Синтаксис

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

Члены

cbStruct

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

dwFlags

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

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

hWndOwner

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

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	oledlg.h

См. также

OleUIInsertObject

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