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.

Nota Passar UI_INVALIDATIONS_ALLPROPERTIES invalida todas as propriedades associadas a um comando, incluindo valor e estado.

 

[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

Confira também

IUIFramework

UI_INVALIDATIONS

Exemplos da Estrutura da Faixa de Opções do Windows