Método IUIFramework::InvalidateUICommand (uiribbon.h)
Invalida uma propriedade, valor ou estado da estrutura da Faixa de Opções do Windows.
Sintaxe
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
Parâmetros
[in] commandId
Tipo: UINT32
A ID do Comando, que é especificada no arquivo de recurso de marcação.
[in] flags
Tipo: UI_INVALIDATIONS
Identifica qual aspecto de um comando invalidar.
[in] key
Tipo: const PROPERTYKEY*
A chave de propriedade da propriedade ou do estado do comando. Este parâmetro pode ser NULL.
Retornar valor
Tipo: HRESULT
Retorna S_OK se tiver êxito; caso contrário, um valor de erro da lista a seguir.
| Valor | Descrição |
|---|---|
| E_INVALIDARG | Um valor inválido para chave foi fornecido. |
| E_FAIL | Falha na operação. Todos os comandos não foram invalidados ou nenhuma das propriedades especificadas tem suporte. |
Comentários
Os recursos definidos na marcação da estrutura da Faixa de Opções são armazenados em uma tabela de recursos criada quando o arquivo de marcação é compilado em formato binário. Um recurso não pode ser restabelecido da tabela de recursos De marcação depois de ter sido invalidado.
Após a invalidação, a estrutura consulta o aplicativo host para obter os detalhes do recurso.
Quando um valor command é invalidado (sinalizadores contém UI_INVALIDATIONS_VALUE) o valor da chave é NULL.
Se IUIFramework::InvalidateUICommand for chamado várias vezes e o valor UI_INVALIDATIONS passado em cada chamada especificar propriedades sobrepostas, como UI_INVALIDATIONS_STATE e UI_INVALIDATIONS_ALLPROPERTIES, apenas um retorno de chamada para o aplicativo host será criado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiribbon.h |
| DLL | Mshtml.dll |