Método IUIFramework::SetUICommandProperty (uiribbon.h)

Establece una propiedad de comando, un valor o un estado.

Sintaxis

HRESULT SetUICommandProperty(
  [in] UINT32         commandId,
  [in] REFPROPERTYKEY key,
  [in] REFPROPVARIANT value
);

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 de la propiedad del comando, valor o estado.

[in] value

Tipo: PROPVARIANT

Propiedad, valor o estado.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve un valor de error de la lista siguiente.

Valor	Descripción
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	La propiedad, valor o estado no admite IUIFramework::SetUICommandProperty. Solo se pueden establecer mediante invalidación.
E_FAIL	Error en la operación.

Comentarios

Se puede establecer un número limitado de claves de propiedad mediante IUIFramework::SetUICommandProperty. Para esas propiedades donde IUIFramework::SetUICommandProperty devuelve HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED), se debe usar IUIFramework::InvalidateUICommand en su lugar.

Para obtener más información sobre cómo establecer una clave de propiedad para un control específico, vea la página Biblioteca de controles del marco de la cinta de opciones de Windows para ese control.

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

IUIFramework

Ejemplos de Windows Ribbon Framework