ViewFilter.IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, поддерживаются указанные команды в данной группе команд.
virtual int Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus(Guid % guidCmdGroup, System::UInt32 cCmds, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECMD> ^ prgCmds, IntPtr pCmdText) = Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget::QueryStatus;
int IOleCommandTarget.QueryStatus (ref Guid guidCmdGroup, uint cCmds, Microsoft.VisualStudio.OLE.Interop.OLECMD[] prgCmds, IntPtr pCmdText);
abstract member Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus : Guid * uint32 * Microsoft.VisualStudio.OLE.Interop.OLECMD[] * nativeint -> int
override this.Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus : Guid * uint32 * Microsoft.VisualStudio.OLE.Interop.OLECMD[] * nativeint -> int
Function QueryStatus (ByRef guidCmdGroup As Guid, cCmds As UInteger, prgCmds As OLECMD(), pCmdText As IntPtr) As Integer Implements IOleCommandTarget.QueryStatus
Параметры
- guidCmdGroup
- Guid
[in] GUID группы команд.
- cCmds
- UInt32
[in] Количество идентификаторов команд, перечисленных в массиве prgCmds.
- prgCmds
- OLECMD[]
[in, out] Массив структур OLECMD, указывающих идентификаторы команд, которые являются предметами запросов. При возврате статус включения каждой команды сохраняется в каждой структуре.
- pCmdText
- IntPtr
[in, out] Неупакованный указатель на структуру OLECMDTEXT, которая получает имя для каждой поддерживаемой команды.
Возвращаемое значение
Возвращает значение S_OK, если выполнение прошло успешно; в противном случае возвращает код ошибки. Типичный код ошибки, который может быть возвращен, имеет вид OLECMDERR_E_UNKNOWNGROUP, что указывает, что группа команд не поддерживается.
Реализации
Комментарии
Этот метод вызывается для получения сведений о состоянии поддержки всех команд в списке для указанной группы команд. Эти сведения используются для включения или отключения параметров меню, а также для определения того, какие команды должны быть переданы в Exec метод в IOleCommandTarget интерфейсе (хотя Exec и должны самостоятельно выполнять проверку поддержки).
Этот метод является реализацией QueryStatus метода в IOleCommandTarget интерфейсе.
Базовый метод вызывает QueryCommandStatus метод для каждой команды в списке и сохраняет результат в OLECMD структуре для этой команды. Если QueryCommandStatus функция возвращает ошибку (например OLECMDERR_E_UNKNOWNGROUP ,), то базовый метод вызывает QueryStatus метод для следующей целевой цели команды в цепочке и сразу же возвращает результат, пропуская все оставшиеся команды в списке (это означает, что QueryCommandStatus метод должен сообщить о допустимом состоянии (поддерживается или не поддерживается) для всех команд, предоставленных ей, если только в этом случае не будет неподдерживаемой вся группа QueryCommandStatus OLECMDERR_E_UNKNOWNGROUP . Базовый метод не задает имя команды в pCmdText структуре, так как реализация по умолчанию для классов языковой службы в среде управляемого пакета не требует изменения имени существующей команды.