Compartilhar via


Método IUIFramework::SetUICommandProperty (uiribbon.h)

Define uma propriedade de comando, um valor ou um estado.

Sintaxe

HRESULT SetUICommandProperty(
  [in] UINT32         commandId,
  [in] REFPROPERTYKEY key,
  [in] REFPROPVARIANT value
);

Parâmetros

[in] commandId

Tipo: UINT32

A ID do Comando, que é especificada no arquivo de recurso De marcação.

[in] key

Tipo: REFPROPERTYKEY

A chave de propriedade da propriedade de comando, valor ou estado.

[in] value

Tipo: PROPVARIANT

A propriedade, o valor ou o estado.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito, caso contrário, um valor de erro da lista a seguir.

Valor Descrição
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) A propriedade, o valor ou o estado não dá suporte a IUIFramework::SetUICommandProperty. Eles podem dar suporte a serem definidos apenas por meio de invalidação.
E_FAIL Falha na operação.

Comentários

Um número limitado de chaves de propriedade pode ser definido usando IUIFramework::SetUICommandProperty. Para as propriedades em que IUIFramework::SetUICommandProperty retorna HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED), IUIFramework::InvalidateUICommand deve ser usado.

Para obter mais informações sobre como definir uma chave de propriedade para um controle específico, consulte a página Biblioteca de Controle da Estrutura da Faixa de Opções do Windows para esse controle.

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

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