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

Invalida una propiedad, valor o estado del marco de la cinta de Opciones de Windows.

Sintaxis

HRESULT InvalidateUICommand(
  [in] UINT32            commandId,
  [in] UI_INVALIDATIONS  flags,
  [in] const PROPERTYKEY *key
);

Parámetros

[in] commandId

Tipo: UINT32

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

[in] flags

Tipo: UI_INVALIDATIONS

Identifica qué aspecto de un comando se va a invalidar.

Nota Pasar UI_INVALIDATIONS_ALLPROPERTIES invalida todas las propiedades enlazadas a un comando, incluido el valor y el estado.

 

[in] key

Tipo: const PROPERTYKEY*

Clave de propiedad de la propiedad o el estado del comando. Este parámetro puede ser NULL.

Valor devuelto

Tipo: HRESULT

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

Valor	Descripción
E_INVALIDARG	Se proporcionó un valor no válido para la clave .
E_FAIL	Error en la operación. No se pudieron invalidar todos los comandos o no se admite ninguna de las propiedades especificadas.

Comentarios

Los recursos definidos en el marcado del marco de la cinta de opciones se almacenan en una tabla de recursos que se crea cuando el archivo de marcado se compila en formato binario. Un recurso no se puede restablecer desde la tabla de recursos de marcado después de que se haya invalidado.

Después de la invalidación, el marco consulta la aplicación host para obtener los detalles del recurso.

Cuando se invalida un valor command (las marcas contienen UI_INVALIDATIONS_VALUE), el valor de la clave es NULL.

Si se llama a IUIFramework::InvalidateUICommand varias veces y el valor de UI_INVALIDATIONS pasado en cada llamada especifica propiedades superpuestas, como UI_INVALIDATIONS_STATE y UI_INVALIDATIONS_ALLPROPERTIES, solo se crea una devolución de llamada a la aplicación host.

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

UI_INVALIDATIONS

Ejemplos de Windows Ribbon Framework