Metodo IUIFramework::InvalidateUICommand (uiribbon.h)
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.
[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 |