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, которая получает имя для каждой поддерживаемой команды.

Возвращаемое значение

Int32

Возвращает значение S_OK, если выполнение прошло успешно; в противном случае возвращает код ошибки. Типичный код ошибки, который может быть возвращен, имеет вид OLECMDERR_E_UNKNOWNGROUP, что указывает, что группа команд не поддерживается.

Реализации

Комментарии

Этот метод вызывается для получения сведений о состоянии поддержки всех команд в списке для указанной группы команд. Эти сведения используются для включения или отключения параметров меню, а также для определения того, какие команды должны быть переданы в Exec метод в IOleCommandTarget интерфейсе (хотя Exec и должны самостоятельно выполнять проверку поддержки).

Этот метод является реализацией QueryStatus метода в IOleCommandTarget интерфейсе.

Базовый метод вызывает QueryCommandStatus метод для каждой команды в списке и сохраняет результат в OLECMD структуре для этой команды. Если QueryCommandStatus функция возвращает ошибку (например OLECMDERR_E_UNKNOWNGROUP ,), то базовый метод вызывает QueryStatus метод для следующей целевой цели команды в цепочке и сразу же возвращает результат, пропуская все оставшиеся команды в списке (это означает, что QueryCommandStatus метод должен сообщить о допустимом состоянии (поддерживается или не поддерживается) для всех команд, предоставленных ей, если только в этом случае не будет неподдерживаемой вся группа QueryCommandStatus OLECMDERR_E_UNKNOWNGROUP . Базовый метод не задает имя команды в pCmdText структуре, так как реализация по умолчанию для классов языковой службы в среде управляемого пакета не требует изменения имени существующей команды.

Применяется к