Win32 API. Справочник по стандартному диалоговому окну
Страница 35. Зарегистрированное сообщение SHAREVISTRING


Зарегистрированное сообщение SHAREVISTRING

Диалоговое окно Открыть (Open) или Сохранить как (Save As) передает зарегистрированное сообщение SHAREVISTRING вашей фильтр - процедуре, если для выбранного файла происходит ошибка совместного доступа, когда пользователь щелкает мышью по кнопке OK.
В диалоговых окнах Открыть (Open) и Сохранить как (Save As) в стиле Проводника , это сообщение было заменено уведомительным сообщением CDN_SHAREVIOLATION.

Синтаксис

MessageID = RegisterWindowMessage(SHAREVISTRING);
wParam = 0;
lpofn = (LPOPENFILENAME) lParam;

Параметры
lpofn
Указатель на структуру OPENFILENAME. Элемент lpstrFile этой структуры содержит имя файла, которое стало причиной ошибки совместного доступа.

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

  • OFN_SHAREFALLTHROUGH - Согласится с именем файла.
  • OFN_SHARENOWARN - Отклоняется имя файла, но пользователь не предупреждается. Прикладная программа ответственна за отображение на экране предупреждающего сообщения.
  • OFN_SHAREWARN - Отклоняется имя файла и отображается предупреждающее сообщение (тот же самый результат, как будто нет никакой фильтр - процедуры).

Замечания
Фильтр - процедура должна определить константу SHAREVISTRING при вызове функции RegisterWindowMessage, чтобы получить идентификатор для сообщения, переданного блоком диалога.
Диалоговое окно передает зарегистрированное сообщение SHAREVISTRING, только тогда, если вы, когда создавали диалог, не определили флажок OFN_SHAREAWARE в элементе Flags структуры OPENFILENAME.
Если фильтр - процедура возвращает неопределенное значение, блок диалога отвечает, как если бы было возвращено значение OFN_SHAREWARN.

Смотри также
CDN_SHAREVIOLATION, OPENFILENAME, RegisterWindowMessage

Размещение и совместимость SHAREVISTRING

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотека-
Заголовочный файлcommdlg.h
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »