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 |