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

Содержит сведения, используемые для инициализации стандартного диалогового окна "Источник изменений ". Это позволяет пользователю изменить назначение или источник ссылки. Это может повлечь за собой выбор другого имени файла для ссылки или, возможно, изменение ссылки на элемент в файле, например изменение целевого диапазона ячеек в электронной таблице, к которым связана ссылка.

Синтаксис

typedef struct tagOLEUICHANGESOURCEW {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCWSTR               lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCWSTR               lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEW         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERW lpOleUILinkContainer;
  DWORD                 dwLink;
  LPWSTR                lpszDisplayName;
  ULONG                 nFileLength;
  LPWSTR                lpszFrom;
  LPWSTR                lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;

Члены

cbStruct

Размер структуры в байтах.

dwFlags

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

Значение	Значение
CSF_SHOWHELP	Включает или отображает кнопку Справка.
CSF_VALIDSOURCE	Указывает, что ссылка была проверена.
CSF_ONLYGETSOURCE	Отключает автоматическую проверку источника ссылки, когда пользователь нажимает кнопку ОК. Если этот флаг указан, следует проверить источник, когда диалоговое окно возвращает ОК.

hWndOwner

Окно, владеющее диалоговым окном.

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

Дескриптор ресурса для настраиваемого диалогового окна. Если этот элемент имеет значение NULL, библиотека использует стандартный шаблон диалогового окна "Преобразование " или, если он действителен, шаблон с именем элемента lpszTemplate .

lpOFN

Указатель на структуру OPENFILENAME , которая содержит сведения, используемые операционной системой для инициализации определенных системой диалоговых окон "Открыть" или "Сохранить как ".

dwReserved1[4]

Этот элемент зарезервирован.

lpOleUILinkContainer

Указатель на реализацию контейнера интерфейса IOleUILinkContainer , используемого для проверки источника ссылки. Диалоговое окно Изменение ссылок использует этот параметр, чтобы разрешить контейнеру управлять своими ссылками.

dwLink

Определяемый контейнером уникальный идентификатор ссылки, используемый для проверки источников ссылок. Используется lpOleUILinkContainer.

lpszDisplayName

Указатель на полное отображаемое имя источника.

nFileLength

Часть моникера файла lpszDisplayName.

lpszFrom

Указатель на префикс источника, который был изменен с.

lpszTo

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

Комментарии

Примечание

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

Требования

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

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

IOleUILinkContainer

OleUIChangeSource