Compartir a través de


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