ViewFilter.IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr) Methode

Definition

Bestimmt, ob die angegebenen Befehle in der angegebenen Befehlsgruppe unterstützt werden.

 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

Parameter

guidCmdGroup
Guid

[in] Die GUID der Befehlsgruppe.

cCmds
UInt32

[in] Die Anzahl der im prgCmds-Array aufgeführten Befehls-IDs.

prgCmds
OLECMD[]

[in, out] Ein Array von OLECMD-Strukturen, das die abgefragten Befehls-IDs angibt. Bei Rückgabe wird der Aktivierstatus eines jeden Befehls in jeder Struktur gespeichert.

pCmdText
IntPtr

[in, out] Ein nicht gemarshallter Zeiger auf eine OLECMDTEXT-Struktur, die den Namen für jeden unterstützten Befehl empfängt.

Gibt zurück

Int32

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben. Ein typischer Fehlercode, der zurückgegeben werden kann, ist OLECMDERR_E_UNKNOWNGROUP , der angibt , dass die Befehlsgruppe nicht unterstützt wird.

Implementiert

Hinweise

Diese Methode wird aufgerufen, um den Unterstützungs Status aller Befehle in der Liste für die angegebene Befehlsgruppe zu erhalten. Diese Informationen werden verwendet, um Menü Optionen zu aktivieren oder zu deaktivieren und um zu bestimmen, welche Befehle an die- Exec Methode der Schnittstelle weitergegeben werden sollen IOleCommandTarget (obwohl auch Exec eine eigene Überprüfung auf Unterstützung durchführen sollte).

Diese Methode ist eine Implementierung der- QueryStatus Methode für die- IOleCommandTarget Schnittstelle.

Die Basis Methode ruft die QueryCommandStatus -Methode für jeden Befehl in der Liste auf und speichert das Ergebnis in der OLECMD Struktur für diesen Befehl. Wenn QueryCommandStatus einen Fehler zurückgibt (z. b. OLECMDERR_E_UNKNOWNGROUP ), ruft die Basis Methode die QueryStatus -Methode für das nächste Befehls Ziel in der Kette auf und gibt das Ergebnis sofort zurück, wobei alle verbleibenden Befehle in der Liste ausgelassen werden. (Dies bedeutet, dass die QueryCommandStatus Methode einen gültigen Status (unterstützt oder nicht unterstützt) für alle Befehle, die an Sie QueryCommandStatus übergeben OLECMDERR_E_UNKNOWNGROUP werden, überspringt. Die Basis Methode legt den Befehlsnamen in der Struktur nicht fest pCmdText , da die Implementierung der Sprachdienst Klassen für das Standard verwaltete Paket Framework den Namen eines vorhandenen Befehls nicht ändern muss.

Gilt für