Перечисление OLECMDID (docobj.h)

Указывает, какая стандартная команда должна быть выполнена. Одно значение из этого перечисления передается в аргументе nCmdIDобъекта IOleCommandTarget::Exec.

Синтаксис

typedef enum OLECMDID {
  OLECMDID_OPEN = 1,
  OLECMDID_NEW = 2,
  OLECMDID_SAVE = 3,
  OLECMDID_SAVEAS = 4,
  OLECMDID_SAVECOPYAS = 5,
  OLECMDID_PRINT = 6,
  OLECMDID_PRINTPREVIEW = 7,
  OLECMDID_PAGESETUP = 8,
  OLECMDID_SPELL = 9,
  OLECMDID_PROPERTIES = 10,
  OLECMDID_CUT = 11,
  OLECMDID_COPY = 12,
  OLECMDID_PASTE = 13,
  OLECMDID_PASTESPECIAL = 14,
  OLECMDID_UNDO = 15,
  OLECMDID_REDO = 16,
  OLECMDID_SELECTALL = 17,
  OLECMDID_CLEARSELECTION = 18,
  OLECMDID_ZOOM = 19,
  OLECMDID_GETZOOMRANGE = 20,
  OLECMDID_UPDATECOMMANDS = 21,
  OLECMDID_REFRESH = 22,
  OLECMDID_STOP = 23,
  OLECMDID_HIDETOOLBARS = 24,
  OLECMDID_SETPROGRESSMAX = 25,
  OLECMDID_SETPROGRESSPOS = 26,
  OLECMDID_SETPROGRESSTEXT = 27,
  OLECMDID_SETTITLE = 28,
  OLECMDID_SETDOWNLOADSTATE = 29,
  OLECMDID_STOPDOWNLOAD = 30,
  OLECMDID_ONTOOLBARACTIVATED = 31,
  OLECMDID_FIND = 32,
  OLECMDID_DELETE = 33,
  OLECMDID_HTTPEQUIV = 34,
  OLECMDID_HTTPEQUIV_DONE = 35,
  OLECMDID_ENABLE_INTERACTION = 36,
  OLECMDID_ONUNLOAD = 37,
  OLECMDID_PROPERTYBAG2 = 38,
  OLECMDID_PREREFRESH = 39,
  OLECMDID_SHOWSCRIPTERROR = 40,
  OLECMDID_SHOWMESSAGE = 41,
  OLECMDID_SHOWFIND = 42,
  OLECMDID_SHOWPAGESETUP = 43,
  OLECMDID_SHOWPRINT = 44,
  OLECMDID_CLOSE = 45,
  OLECMDID_ALLOWUILESSSAVEAS = 46,
  OLECMDID_DONTDOWNLOADCSS = 47,
  OLECMDID_UPDATEPAGESTATUS = 48,
  OLECMDID_PRINT2 = 49,
  OLECMDID_PRINTPREVIEW2 = 50,
  OLECMDID_SETPRINTTEMPLATE = 51,
  OLECMDID_GETPRINTTEMPLATE = 52,
  OLECMDID_PAGEACTIONBLOCKED = 55,
  OLECMDID_PAGEACTIONUIQUERY = 56,
  OLECMDID_FOCUSVIEWCONTROLS = 57,
  OLECMDID_FOCUSVIEWCONTROLSQUERY = 58,
  OLECMDID_SHOWPAGEACTIONMENU = 59,
  OLECMDID_ADDTRAVELENTRY = 60,
  OLECMDID_UPDATETRAVELENTRY = 61,
  OLECMDID_UPDATEBACKFORWARDSTATE = 62,
  OLECMDID_OPTICAL_ZOOM = 63,
  OLECMDID_OPTICAL_GETZOOMRANGE = 64,
  OLECMDID_WINDOWSTATECHANGED = 65,
  OLECMDID_ACTIVEXINSTALLSCOPE = 66,
  OLECMDID_UPDATETRAVELENTRY_DATARECOVERY = 67,
  OLECMDID_SHOWTASKDLG = 68,
  OLECMDID_POPSTATEEVENT = 69,
  OLECMDID_VIEWPORT_MODE = 70,
  OLECMDID_LAYOUT_VIEWPORT_WIDTH = 71,
  OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM = 72,
  OLECMDID_USER_OPTICAL_ZOOM = 73,
  OLECMDID_PAGEAVAILABLE = 74,
  OLECMDID_GETUSERSCALABLE = 75,
  OLECMDID_UPDATE_CARET = 76,
  OLECMDID_ENABLE_VISIBILITY = 77,
  OLECMDID_MEDIA_PLAYBACK = 78,
  OLECMDID_SETFAVICON = 79,
  OLECMDID_SET_HOST_FULLSCREENMODE = 80,
  OLECMDID_EXITFULLSCREEN = 81,
  OLECMDID_SCROLLCOMPLETE = 82,
  OLECMDID_ONBEFOREUNLOAD = 83,
  OLECMDID_SHOWMESSAGE_BLOCKABLE = 84,
  OLECMDID_SHOWTASKDLG_BLOCKABLE = 85
} ;

Константы

OLECMDID_OPEN Значение: 1 Меню "Файл" , команда "Открыть "
OLECMDID_NEW Значение: 2 Меню "Файл ", команда "Создать "
OLECMDID_SAVE Значение: 3 Меню "Файл", команда "Сохранить"
OLECMDID_SAVEAS Значение: 4 Меню "Файл ", команда "Сохранить как "
OLECMDID_SAVECOPYAS Значение: 5 Меню "Файл ", команда "Сохранить копию как "
OLECMDID_PRINT Значение: 6 Меню "Файл", команда "Печать"
OLECMDID_PRINTPREVIEW Значение: 7 Меню "Файл", команда "Предварительный просмотр"
OLECMDID_PAGESETUP Значение: 8 Меню "Файл", команда "Настройка страницы"
OLECMDID_SPELL Значение: 9 Меню "Сервис", команда "Орфография"
OLECMDID_PROPERTIES Значение: 10 Меню "Файл", команда "Свойства"
OLECMDID_CUT Значение: 11 Меню "Правка" , команда "Вырезать "
OLECMDID_COPY Значение: 12 Меню правки, команда "Копировать"
OLECMDID_PASTE Значение: 13 Меню "Правка", команда "Вставить"
OLECMDID_PASTESPECIAL Значение: 14 Меню "Правка" , команда "Специальная вставка "
OLECMDID_UNDO Значение: 15 Меню "Правка", команда "Отменить"
OLECMDID_REDO Значение: 16 Меню "Правка", команда "Повторить"
OLECMDID_SELECTALL Значение: 17 Меню "Правка ", команда "Выбрать все "
OLECMDID_CLEARSELECTION Значение: 18 Меню "Правка" , команда "Очистить "
OLECMDID_ZOOM Значение: 19 Меню "Вид" , команда "Масштаб " (дополнительные сведения см. ниже).
OLECMDID_GETZOOMRANGE Значение: 20 Возвращает диапазон масштабирования, применимый к представлению масштаба (дополнительные сведения см. ниже).
OLECMDID_UPDATECOMMANDS Значение: 21 Сообщает получателю (обычно кадру) об изменениях состояния. Затем получатель может запрашивать состояние команд, когда это удобно.
OLECMDID_REFRESH Значение: 22 Запрашивает у получателя обновление своего дисплея. Реализуется документом или объектом .
OLECMDID_STOP Значение: 23 Останавливает всю текущую обработку. Реализуется документом или объектом .
OLECMDID_HIDETOOLBARS Значение: 24 Меню "Вид ", команда "Панели инструментов ". Реализуется документом или объектом для скрытия панелей инструментов.
OLECMDID_SETPROGRESSMAX Значение: 25 Задает максимальное значение индикатора хода выполнения, если он принадлежит принимающему объекту( обычно это кадр). Минимальное значение всегда равно нулю.
OLECMDID_SETPROGRESSPOS Значение: 26 Задает текущее значение индикатора хода выполнения, если он принадлежит принимающему объекту( обычно это кадр).
OLECMDID_SETPROGRESSTEXT Значение: 27 Задает текст, содержащийся в индикаторе хода выполнения, если он принадлежит принимающему объекту, обычно фрейму. Если у получателя в настоящее время нет индикатора хода выполнения, этот текст должен отображаться в строке состояния (если таковой существует), как в IOleInPlaceFrame::SetStatusText.
OLECMDID_SETTITLE Значение: 28 Задает текст строки заголовка принимающего объекта, обычно фрейма.
OLECMDID_SETDOWNLOADSTATE Значение: 29 Вызывается объектом при скачивании изменений состояния. Принимает параметр VT_BOOL, который имеет значение TRUE , если объект загружает данные, и FALSE , если это не так. В основном реализуется кадром.
OLECMDID_STOPDOWNLOAD Значение: 30 Останавливает скачивание при выполнении. Как правило, эта команда распространяется на все содержащиеся объекты. При запросе задает MSOCMDF_ENABLED. Реализуется документом или объектом .
OLECMDID_ONTOOLBARACTIVATED Значение: 31
OLECMDID_FIND Значение: 32 Меню "Правка" , команда "Найти "
OLECMDID_DELETE Значение: 33 Меню "Правка" , команда "Удалить "
OLECMDID_HTTPEQUIV Значение: 34 Выдается в ответ на метатег HTTP-EQUIV и приводит к вызову нерекомендуемого метода OnHttpEquiv с параметром fDone, равным false. Эта команда принимает параметр VT_BSTR , который передается в OnHttpEquiv.
OLECMDID_HTTPEQUIV_DONE Значение: 35 Выдается в ответ на метатег HTTP-EQUIV и приводит к вызову нерекомендуемого метода OnHttpEquiv с параметром fDone, равным true. Эта команда принимает параметр VT_BSTR , который передается в OnHttpEquiv.
OLECMDID_ENABLE_INTERACTION Значение: 36 Приостанавливает или возобновляет взаимодействие с приемником. Эта команда принимает параметр VT_BOOL , который приостанавливает взаимодействие, если задано значение FALSE , и возобновляет взаимодействие, если задано значение TRUE.
OLECMDID_ONUNLOAD Значение: 37 Уведомляет получателя о намерении закрыть окно в ближайшее время. Эта команда принимает VT_BOOL выходной параметр, который возвращает значение TRUE , если получатель может закрыться, и FALSE , если не удается.
OLECMDID_PROPERTYBAG2 Значение: 38 Эта команда не действует.
OLECMDID_PREREFRESH Значение: 39 Уведомляет получателя о том, что обновление вот-вот начнется.
OLECMDID_SHOWSCRIPTERROR Значение: 40 Указывает получателю отобразить сообщение об ошибке скрипта.
OLECMDID_SHOWMESSAGE Значение: 41 Эта команда принимает входной параметр IHTMLEventObj , содержащий сообщение, отображаемое получателем.
OLECMDID_SHOWFIND Значение: 42 Указывает получателю отобразить диалоговое окно Найти. Он принимает VT_DISPATCH входной параметр.
OLECMDID_SHOWPAGESETUP Значение: 43 Указывает получателю отобразить диалоговое окно Параметры страницы. Он принимает входной параметр IHTMLEventObj2 .
OLECMDID_SHOWPRINT Значение: 44 Указывает получателю отобразить диалоговое окно Печать. Он принимает входной параметр IHTMLEventObj2 .
OLECMDID_CLOSE Значение: 45 Команда выхода для меню Файл.
OLECMDID_ALLOWUILESSSAVEAS Значение: 46 Поддерживает метод QueryStatus .
OLECMDID_DONTDOWNLOADCSS Значение: 47 Уведомляет получателя о том, что css-файлы не следует загружать в DesignMode.
OLECMDID_UPDATEPAGESTATUS Значение: 48 Эта команда не действует.
OLECMDID_PRINT2 Значение: 49 Меню "Файл", обновленная команда "Печать"
OLECMDID_PRINTPREVIEW2 Значение: 50 Меню "Файл", обновленная команда "Предварительный просмотр"
OLECMDID_SETPRINTTEMPLATE Значение: 51 Задает явное значение шаблона печати TRUE или FALSE на основе VT_BOOL входного параметра.
OLECMDID_GETPRINTTEMPLATE Значение: 52 Возвращает VT_BOOL выходной параметр, указывающий, имеет ли значение шаблона печати значение TRUE или FALSE.
OLECMDID_PAGEACTIONBLOCKED Значение: 55 Указывает, что действие страницы заблокировано. PAGEACTIONBLOCKED предназначен для использования с приложениями, в которых размещен элемент управления WebBrowser в Интернете Обозреватель для реализации собственного пользовательского интерфейса.
OLECMDID_PAGEACTIONUIQUERY Значение: 56 Указывает, какие действия отображаются в диапазоне уведомлений Обозреватель Интернета.
OLECMDID_FOCUSVIEWCONTROLS Значение: 57 Заставляет элемент управления Internet Обозреватель WebBrowser фокусировать область уведомлений по умолчанию. Узлы могут отправить эту команду в любое время. Возвращаемое значение S_OK, если полоса присутствует и находится в фокусе, или S_FALSE в противном случае.
OLECMDID_FOCUSVIEWCONTROLSQUERY Значение: 58 Это событие уведомления предоставляется для приложений, которые отображают реализацию диапазона уведомлений Internet Explorer по умолчанию. По умолчанию, когда пользователь нажимает сочетание клавиш ALT-N, интернет-Обозреватель рассматривает это как запрос на фокусировку диапазона уведомлений.
OLECMDID_SHOWPAGEACTIONMENU Значение: 59 Заставляет элемент управления Internet Обозреватель WebBrowser отображать меню Информационной панели.
OLECMDID_ADDTRAVELENTRY Значение: 60 Заставляет элемент управления Internet Обозреватель WebBrowser создать запись в текущем смещении журнала путешествий. Docobject должен реализовывать интерфейсы ITravelLogClient и IPersist , которые используются журналом путешествий при обработке этой команды с вызовами GetWindowData и GetPersistID соответственно.
OLECMDID_UPDATETRAVELENTRY Значение: 61 Вызывается при обработке LoadHistory для обновления предыдущего состояния Docobject. Для синхронной обработки эту команду можно вызвать перед возвратом из вызова LoadHistory. Для асинхронной обработки его можно вызвать позже.
OLECMDID_UPDATEBACKFORWARDSTATE Значение: 62 Обновления состояние кнопок браузера Назад и Вперед.
OLECMDID_OPTICAL_ZOOM Значение: 63 Windows Internet Обозреватель 7 и более поздних версий. Задает коэффициент масштаба браузера. Принимает параметр VT_I4 в диапазоне от 10 до 1000 (процент).
OLECMDID_OPTICAL_GETZOOMRANGE Значение: 64 Windows Internet Обозреватель 7 и более поздних версий. Извлекает минимальные и максимальные ограничения коэффициента масштабирования браузера. Возвращает параметр VT_I4; LOWORD является минимальным коэффициентом масштабирования, а HIWORD — максимальным.
OLECMDID_WINDOWSTATECHANGED Значение: 65 Windows Internet Обозреватель 7 и более поздних версий. Уведомляет интернет-Обозреватель Элемент управления WebBrowser об изменениях в состояниях окна, таких как потеря фокуса, скрытие или свертывание. Узел указывает, что изменилось, задав флаги параметров OLECMDID_WINDOWSTATE_FLAG в nCmdExecOpt.
OLECMDID_ACTIVEXINSTALLSCOPE Значение: 66 Windows Internet Обозреватель 8 с Windows Vista. Не влияет на Windows Internet Обозреватель 8 с Windows XP. Уведомляет Trident об использовании указанной области установки для установки элемента ActiveX, указанного указанным идентификатором класса. Дополнительные сведения см. в разделе «Примечания».
OLECMDID_UPDATETRAVELENTRY_DATARECOVERY Значение: 67 Интернет Обозреватель 8. В отличие от OLECMDID_UPDATETRAVELENTRY, при этом обновляется запись журнала путешествий, которая не инициализирована из предыдущего состояния Docobject. Хотя эта команда не вызывается из IPersistHistory::LoadHistory, ее можно вызвать отдельно для сохранения состояния браузера, которое можно использовать позже для восстановления после сбоя.
OLECMDID_SHOWTASKDLG Значение: 68
OLECMDID_POPSTATEEVENT Значение: 69
OLECMDID_VIEWPORT_MODE Значение: 70
OLECMDID_LAYOUT_VIEWPORT_WIDTH Значение: 71
OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM Значение: 72
OLECMDID_USER_OPTICAL_ZOOM Значение: 73
OLECMDID_PAGEAVAILABLE Значение: 74
OLECMDID_GETUSERSCALABLE Значение: 75
OLECMDID_UPDATE_CARET Значение: 76
OLECMDID_ENABLE_VISIBILITY Значение: 77
OLECMDID_MEDIA_PLAYBACK Значение: 78
OLECMDID_SETFAVICON Значение: 79
OLECMDID_SET_HOST_FULLSCREENMODE Значение: 80
OLECMDID_EXITFULLSCREEN Значение: 81
OLECMDID_SCROLLCOMPLETE Значение: 82
OLECMDID_ONBEFOREUNLOAD Значение: 83
OLECMDID_SHOWMESSAGE_BLOCKABLE Значение: 84
OLECMDID_SHOWTASKDLG_BLOCKABLE Значение: 85

Комментарии

В технологии составных документов OLE объект, редактируемый на месте, отключает элемент управления Zoom на панели инструментов и команду Zoom в меню Вид , так как команда Zoom логически применяется к документу контейнера, а не к объекту. Команды OLECMDID_ZOOM и OLECMDID_GETZOOMRANGE уведомляют объект фрейма контейнера о диапазоне масштабирования, который он должен использовать для отображения объекта документа в пользовательском интерфейсе. Фрейм контейнера — это клиентский объект, реализующий IOleInPlaceFrame и, при необходимости, IOleCommandTarget.

Команда OLECMDID_ZOOM принимает один аргумент LONG в качестве входных данных и записывает один аргумент LONG в выходные данные. Эта команда используется для трех целей:

• Запрос текущего значения масштаба. Вызывающий объект IOleCommandTarget::Exec передает OLECMDEXECOPT_DONTPROMPTUSER в качестве параметра execute в nCmdExecOpt и NULL для pvIn. Объект возвращает текущее значение масштаба в pvaOut. Когда объект становится активным в пользовательском интерфейсе, он получает текущее значение масштаба из объекта фрейма контейнера с помощью этого же механизма и обновляет свой элемент управления масштабированием с помощью возвращаемого значения.
• Отображение диалогового окна Масштаб . Вызывающий объект IOleCommandTarget::Exec передает OLECMDEXECOPT_PROMPTUSER в nCmdExecOpt. При необходимости вызывающий объект может передать начальное значение диалогового окна через pvaIn; В противном случае pvaIn должен иметь значение NULL. Если пользователь нажимает кнопку Отмена, объект возвращает OLECMDERR_E_CANCELED. Если пользователь нажимает кнопку ОК, объект передает выбранное пользователем значение в pvaOut. Когда пользователь выбирает команду Zoom в меню Вид , объект вызывает объект фрейма контейнера таким же образом. Затем контейнер масштабирует документ до выбранного пользователем значения, и объект обновляет свой элемент управления Zoom с этим значением.
• Установка значения масштаба . Вызывающий объект IOleCommandTarget::Exec передает OLECMDEXECOPT_DONTPROMPTUSER в nCmdExecOpt и передает значение масштаба для применения через pvaIn. Объект проверяет и нормализует новое значение и возвращает проверенное значение в pvaOut. Когда пользователь выбирает новое значение масштаба (например, с помощью элемента управления Масштаб на панели инструментов), объект вызывает объект кадра контейнера таким образом. Контейнер масштабирует документ до 100 процентов, а объект обновляет элемент управления Zoom этим значением.

Команда OLECMDID_GETZOOMRANGE используется для определения диапазона допустимых значений масштаба из объекта, реализующего IOleCommandTarget. Вызывающий объект передает MSOCMDEXECOPT_DONTPROMPTUSER в nCmdExecOpt и NULL для pvaIn. Объект возвращает свой диапазон масштабирования в pvaOut, где HIWORD содержит максимальное значение масштаба, а LOWORD содержит минимальное значение масштабирования. Обычно эта команда используется, когда пользователь раскрывает элемент управления Масштаб на панели инструментов объекта, активного в пользовательском интерфейсе. Приложения и объекты, поддерживающие эту команду, должны поддерживать все целочисленные значения масштаба, которые находятся в паре (min,max), которую они возвращают.

Команда OLECMDID_ACTIVEXINSTALLSCOPE уведомляет Trident об использовании указанной области установки для установки элемента Управления ActiveX, указанного указанным идентификатором класса. Область установки передается в VT_ARRAY в pvaIn метода IOleCommandTarget::Exec , элементы которого приведены ниже.

Данные	Тип VARIANT	Индекс
Идентификатор класса	VT_BSTR	0
Область установки	VT_UI4	1

 

Область установки должно иметь одно из следующих значений.

Значение	Описание
INSTALL_SCOPE_USERS	Элемент Управления ActiveX должен регистрироваться в HKCU и только для мгновенного пользователя.
INSTALL_SCOPE_MACHINE	Элемент Управления ActiveX должен регистрироваться в HKLM и на компьютере.

 

Ниже приведен пример использования команды OLECMDID_ACTIVEXINSTALLSCOPE.

IOleCommandTarget::Exec(
NULL, // Pointer to command group
OLECMDARGINDEX_ACTIVEXINSTALL_INSTALLSCOPE, // ID of command to execute
NULL, // Options
&varArgs, // pvain pointer to input arguments
NULL) // pointer to command output

Требования

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

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

IOleCommandTarget

IOleCommandTarget::Exec

IOleInPlaceFrame