Método IUIFramework::InvalidateUICommand (uiribbon.h)
Invalida una propiedad, valor o estado del marco de la cinta de Opciones de Windows.
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
[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.
[in] key
Tipo: const PROPERTYKEY*
Clave de propiedad de la propiedad o el estado del comando. Este parámetro puede ser NULL.
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. |
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.
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 |