Metodo IOleCommandTarget::QueryStatus (docobj.h)

Articolo
08/23/2023

Esegue una query sull'oggetto per lo stato di uno o più comandi generati dagli eventi dell'interfaccia utente.

Sintassi

HRESULT QueryStatus(
  [in]      const GUID *pguidCmdGroup,
  [in]      ULONG      cCmds,
  [in, out] OLECMD []  prgCmds,
  [in, out] OLECMDTEXT *pCmdText
);

Parametri

[in] pguidCmdGroup

Identificatore univoco del gruppo di comandi; può essere NULL per specificare il gruppo standard. Tutti i comandi passati nella matrice prgCmds devono appartenere al gruppo specificato da pguidCmdGroup.

[in] cCmds

Numero di comandi nella matrice prgCmds .

[in, out] prgCmds

Matrice allocata dal chiamante di strutture OLECMD che indicano i comandi per cui il chiamante necessita di informazioni sullo stato. Questo metodo riempie il membro cmdf di ogni struttura con i valori acquisiti dall'enumerazione OLECMDF .

[in, out] pCmdText

Puntatore a una struttura OLECMDTEXT in cui restituire informazioni sul nome e/o sullo stato di un singolo comando. Questo parametro può essere NULL per indicare che il chiamante non necessita di queste informazioni.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_UNEXPECTED	Si è verificato un errore imprevisto.
E_POINTER	L'argomento prgCmds è NULL.
OLECMDERR_E_UNKNOWNGROUP	Il parametro pguidCmdGroup non è NULL , ma non specifica un gruppo di comandi riconosciuto.

Commenti

I chiamanti usano QueryStatus per determinare quali comandi sono supportati da un oggetto di destinazione. Il chiamante può quindi disabilitare i comandi non disponibili che altrimenti verrebbero indirizzati all'oggetto . Il chiamante può anche usare questo metodo per ottenere il nome o lo stato di un singolo comando.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h

Vedi anche

Share via