Metodo IUIFramework::InvalidateUICommand (uiribbon.h)

  • Articolo

Invalida una proprietà del framework della barra multifunzione di Windows, un valore o uno stato.

Sintassi

HRESULT InvalidateUICommand(
  [in] UINT32            commandId,
  [in] UI_INVALIDATIONS  flags,
  [in] const PROPERTYKEY *key
);

Parametri

[in] commandId

Tipo: UINT32

ID per il comando, specificato nel file di risorse di markup.

[in] flags

Tipo: UI_INVALIDATIONS

Identifica l'aspetto di un comando da invalidare.

Nota Passando UI_INVALIDATIONS_ALLPROPERTIES invalida tutte le proprietà associate a un comando, incluso valore e stato.
 

[in] key

Tipo: const PROPERTYKEY*

Chiave della proprietà della proprietà o dello stato del comando. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo; in caso contrario, un valore di errore dall'elenco seguente.

Valore Descrizione
E_INVALIDARG È stato fornito un valore non valido per la chiave .
E_FAIL Operazione non riuscita. Tutti i comandi non sono riusciti a invalidare o nessuno delle proprietà specificate è supportato.

Commenti

Le risorse definite nel markup del framework della barra multifunzione vengono archiviate in una tabella di risorse creata quando il file di markup viene compilato in formato binario. Non è possibile reinserire una risorsa dalla tabella delle risorse markup dopo che è stata invalidata.

Dopo l'invalidazione, il framework esegue una query sull'applicazione host per i dettagli della risorsa.

Quando un valore di comando non è valido (i flag contengono UI_INVALIDATIONS_VALUE) il valore della chiave è NULL.

Se IUIFramework::InvalidateUICommand viene chiamato più volte e il valore UI_INVALIDATIONS passato in ogni chiamata specifica proprietà sovrapposte, ad esempio UI_INVALIDATIONS_STATE e UI_INVALIDATIONS_ALLPROPERTIES, viene creato un solo callback all'applicazione host.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiribbon.h
DLL Mshtml.dll

Vedi anche

IUIFramework

UI_INVALIDATIONS

Esempi di Framework della barra multifunzione di Windows