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

Responde a las solicitudes de actualización de propiedades del marco de la cinta de Opciones de Windows.

Sintaxis

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

Parámetros

[in] commandId

Tipo: UINT32

Identificador del comando, que se especifica en el archivo de recursos de marcado.

[in] key

Tipo: REFPROPERTYKEY

Clave de propiedad que se va a actualizar.

[in, optional] currentValue

Tipo: const PROPVARIANT*

Puntero al valor actual de la clave. Este parámetro puede ser NULL.

[out] newValue

Tipo: PROPVARIANT*

Cuando este método vuelve, contiene un puntero al nuevo valor de la clave.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método debe poder devolverse antes de que se realicen llamadas posteriores al marco de la cinta de opciones.

Los valores de las propiedades Command, como UI_PKEY_Enabled o UI_PKEY_Label, se establecen mediante llamadas a SetUICommandProperty o InvalidateUICommand.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiribbon.h
Archivo DLL	Mshtml.dll

Consulte también

IUICommandHandler

Ejemplos de Windows Ribbon Framework