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

Статья
11/20/2024

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

Синтаксис

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, библиотека использует изменения источника.

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

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

lpOFN

Указатель на структуру OPENFILENAME , содержащую сведения, используемые операционной системой для инициализации системных диалоговых окон Open или Save As.

dwReserved1[4]

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

lpOleUILinkContainer

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

dwLink

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

lpszDisplayName

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

nFileLength

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

lpszFrom

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

lpszTo

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

Замечания

Заметка

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

Требования

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

См. также

IOleUILinkContainer

OleUIChangeSource

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