Metodo IUICommandHandler::UpdateProperty (uiribbon.h)

Risponde alle richieste di aggiornamento delle proprietà dal framework della barra multifunzione di Windows.

Sintassi

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

Parametri

[in] commandId

Tipo: UINT32

ID per il comando, specificato nel file di risorsa Markup.

[in] key

Tipo: REFPROPERTYKEY

Chiave della proprietà da aggiornare.

[in, optional] currentValue

Tipo: const PROPVARIANT*

Puntatore al valore corrente per la chiave. Questo parametro può essere NULL.

[out] newValue

Tipo: PROPVARIANT*

Quando questo metodo restituisce, contiene un puntatore al nuovo valore per la chiave.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo deve essere consentito prima che vengano eseguite chiamate successive al framework della barra multifunzione.

I valori delle proprietà del comando, ad esempio UI_PKEY_Enabled o UI_PKEY_Label, vengono impostati tramite chiamate a SetUICommandProperty o InvalidateUICommand.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiribbon.h
DLL	Mshtml.dll

Vedi anche

IUICommandHandler

Esempi di Framework della barra multifunzione di Windows