Método IUICommandHandler::UpdateProperty (uiribbon.h)

  • Artigo

Responde a solicitações de atualização de propriedade da estrutura da Faixa de Opções do Windows.

Sintaxe

HRESULT UpdateProperty(
  [in]           UINT32            commandId,
  [in]           REFPROPERTYKEY    key,
  [in, optional] const PROPVARIANT *currentValue,
  [out]          PROPVARIANT       *newValue
);

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 a ser atualizada.

[in, optional] currentValue

Tipo: const PROPVARIANT*

Um ponteiro para o valor atual da chave. Este parâmetro pode ser NULL.

[out] newValue

Tipo: PROPVARIANT*

Quando esse método é retornado, ele contém um ponteiro para o novo valor da chave.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método deve ter permissão para retornar antes que as chamadas subsequentes para a estrutura da Faixa de Opções sejam feitas.

Os valores das propriedades Command, como UI_PKEY_Enabled ou UI_PKEY_Label, são definidos por meio de chamadas para SetUICommandProperty ou InvalidateUICommand.

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

IUICommandHandler

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