Método IUICommandHandler::UpdateProperty (uiribbon.h)
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 |