Habilitar los estilos visuales

En este tema se explica cómo configurar la aplicación para asegurarse de que los controles comunes se muestran en el estilo visual preferido del usuario.

En este tema se incluyen las secciones siguientes.

• Usar manifiestos o directivas para asegurarse de que los estilos visuales se pueden aplicar a las aplicaciones
• Uso de ComCtl32.dll versión 6 en una aplicación que solo usa extensiones estándar
• Uso de ComCtl32 versión 6 en Panel de control o un archivo DLL que se ejecuta mediante RunDll32.exe
• Agregar compatibilidad de estilo visual a una extensión, complemento, complemento MMC o un archivo DLL que se introduce en un proceso
• Desactivar estilos visuales
• Uso de estilos visuales con contenido HTML
• Cuando no se aplican estilos visuales
• Hacer que la aplicación sea compatible con versiones anteriores de Windows
• Temas relacionados

Usar manifiestos o directivas para asegurarse de que los estilos visuales se pueden aplicar a las aplicaciones

Para permitir que la aplicación use estilos visuales, debe usar ComCtl32.dll versión 6 o posterior. Dado que la versión 6 no es redistribuible, solo está disponible cuando la aplicación se ejecuta en una versión de Windows que la contiene. Windows se incluye con la versión 5 y la versión 6. ComCtl32.dll versión 6 contiene los controles de usuario y los controles comunes. De forma predeterminada, las aplicaciones usan los controles de usuario definidos en User32.dll y los controles comunes definidos en ComCtl32.dll versión 5. Para obtener una lista de las versiones dll y sus plataformas de distribución, consulte Versiones de control comunes.

Si quiere que la aplicación use estilos visuales, debe agregar un manifiesto de aplicación o una directiva del compilador que indique que se debe usar ComCtl32.dll versión 6 si está disponible.

Un manifiesto de aplicación permite a una aplicación especificar qué versiones de un ensamblado requiere. En Microsoft Win32, un ensamblado es un conjunto de archivos DLL y una lista de objetos versionables contenidos en esos archivos DLL.

Los manifiestos se escriben en XML. El nombre del archivo de manifiesto de aplicación es el nombre del archivo ejecutable seguido de la extensión de nombre de archivo .manifest; por ejemplo, MyApp.exe.manifest. El siguiente manifiesto de ejemplo muestra que la primera sección describe el propio manifiesto. En la tabla siguiente se muestran los atributos establecidos por el elemento assemblyIdentity en la sección de descripción del manifiesto.

El manifiesto de ejemplo también proporciona una descripción de la aplicación y especifica las dependencias de la aplicación. En la tabla siguiente se muestran los atributos establecidos por el elemento assemblyIdentity en la sección de dependencias.

A continuación se muestra un ejemplo de un archivo de manifiesto.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
<assemblyIdentity
    version="1.0.0.0"
    processorArchitecture="*"
    name="CompanyName.ProductName.YourApplication"
    type="win32"
/>
<description>Your application description here.</description>
<dependency>
    <dependentAssembly>
        <assemblyIdentity
            type="win32"
            name="Microsoft.Windows.Common-Controls"
            version="6.0.0.0"
            processorArchitecture="*"
            publicKeyToken="6595b64144ccf1df"
            language="*"
        />
    </dependentAssembly>
</dependency>
</assembly>

Si usa Microsoft Visual C++ 2005 o posterior, puede agregar la siguiente directiva del compilador al código fuente en lugar de crear manualmente un manifiesto. Para mayor legibilidad, la directiva se divide en varias líneas aquí.

#pragma comment(linker,"\"/manifestdependency:type='win32' \
name='Microsoft.Windows.Common-Controls' version='6.0.0.0' \
processorArchitecture='*' publicKeyToken='6595b64144ccf1df' language='*'\"")

En los temas siguientes se describen los pasos para aplicar estilos visuales a diferentes tipos de aplicaciones. Observe que el formato del manifiesto es el mismo en cada caso.

Uso de ComCtl32.dll versión 6 en una aplicación que solo usa extensiones estándar

A continuación se muestran ejemplos de aplicaciones que no usan extensiones de terceros.

• Calculadora
• FreeCell (en Windows Vista y Windows 7)
• Mineweeper (en Windows Vista y Windows 7)
• Notepad
• Solitario (en Windows Vista y Windows 7)

Para crear un manifiesto y permitir que la aplicación use estilos visuales.

1. Vincula a ComCtl32.lib y llama a InitCommonControls.

2. Agregue un archivo denominado YourApp.exe.manifest al árbol de origen que tenga el formato de manifiesto XML.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity
       version="1.0.0.0"
       processorArchitecture="*"
       name="CompanyName.ProductName.YourApplication"
       type="win32"
   />
   <description>Your application description here.</description>
   <dependency>
       <dependentAssembly>
           <assemblyIdentity
               type="win32"
               name="Microsoft.Windows.Common-Controls"
               version="6.0.0.0"
               processorArchitecture="*"
               publicKeyToken="6595b64144ccf1df"
               language="*"
           />
       </dependentAssembly>
   </dependency>
   </assembly>
   

3. Agregue el manifiesto al archivo de recursos de la aplicación de la siguiente manera:

   CREATEPROCESS_MANIFEST_RESOURCE_ID RT_MANIFEST "YourApp.exe.manifest"
   

   Nota:

   Al agregar la entrada anterior al recurso, debe formatearla en una línea. Como alternativa, puede colocar el archivo de manifiesto XML en el mismo directorio que el archivo ejecutable de la aplicación. El sistema operativo cargará primero el manifiesto desde el sistema de archivos y, a continuación, comprobará la sección de recursos del ejecutable. La versión del sistema de archivos tiene prioridad.

    

Al compilar la aplicación, el manifiesto se agregará como un recurso binario.

Uso de ComCtl32 versión 6 en Panel de control o un archivo DLL que se ejecuta mediante RunDll32.exe

Para crear un manifiesto y permitir que la aplicación use estilos visuales.

1. Vincula a ComCtl32.lib y llama a InitCommonControls.

2. Agregue un archivo denominado YourApp.cpl.manifest al árbol de origen que tenga el formato de manifiesto XML.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity
       version="1.0.0.0"
       processorArchitecture="*"
       name="CompanyName.ProductName.YourApplication"
       type="win32"
   />
   <description>Your application description here.</description>
   <dependency>
       <dependentAssembly>
           <assemblyIdentity
               type="win32"
               name="Microsoft.Windows.Common-Controls"
               version="6.0.0.0"
               processorArchitecture="*"
               publicKeyToken="6595b64144ccf1df"
               language="*"
           />
       </dependentAssembly>
   </dependency>
   </assembly>
   

3. Agregue el manifiesto al archivo de recursos de la aplicación como identificador de recurso 123.

Agregar compatibilidad de estilo visual a una extensión, complemento, complemento MMC o un archivo DLL que se introduce en un proceso

La compatibilidad con estilos visuales se puede agregar a una extensión, un complemento MMC o un archivo DLL que se introduce en un proceso. Por ejemplo, siga estos pasos para agregar compatibilidad con estilos visuales para un complemento de Microsoft Management Console (MMC).

1. Compile el complemento con la marca -DISOLATION_AWARE_ENABLED o inserte la siguiente instrucción antes de la instrucción #include "windows.h".

   #define ISOLATION_AWARE_ENABLED 1
   

   Para obtener más información sobre ISOLATION_AWARE_ENABLED, consulte Aislamiento de componentes.

2. Incluya el archivo de encabezado de control común en el origen del complemento.

   #include <commctrl.h>
   

3. Agregue un archivo denominado YourApp.manifest al árbol de origen que usa el formato de manifiesto XML.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity
       version="1.0.0.0"
       processorArchitecture="*"
       name="CompanyName.ProductName.YourApplication"
       type="win32"
   />
   <description>Your application description here.</description>
   <dependency>
       <dependentAssembly>
           <assemblyIdentity
               type="win32"
               name="Microsoft.Windows.Common-Controls"
               version="6.0.0.0"
               processorArchitecture="*"
               publicKeyToken="6595b64144ccf1df"
               language="*"
           />
       </dependentAssembly>
   </dependency>
   </assembly>
   

4. Agregue el manifiesto al archivo de recursos del complemento. Consulte Uso de ComCtl32 versión 6 en una aplicación que usa extensiones, complementos o un archivo DLL que se incluye en un proceso para obtener más información sobre cómo agregar un manifiesto a un archivo de recursos.

Desactivar estilos visuales

Puede desactivar los estilos visuales de un control o para todos los controles de una ventana llamando a la función SetWindowTheme de la siguiente manera:

SetWindowTheme(hwnd, L" ", L" ");

En el ejemplo anterior, hwnd es el identificador de la ventana en la que se deshabilitarán los estilos visuales. Después de la llamada, el control se representa sin estilos visuales.

Uso de estilos visuales con contenido HTML

Las páginas HTML que modifican las propiedades de hojas de estilos en cascada (CSS), como el fondo o el borde, no tienen estilos visuales aplicados. Muestran el atributo CSS especificado. Cuando se especifica como parte del contenido, la mayoría de las propiedades CSS se aplican a los elementos que tienen estilos visuales aplicados.

De forma predeterminada, los estilos visuales se aplican a controles HTML intrínsecos en las páginas mostradas en Microsoft Internet Explorer 6 y versiones posteriores. Para desactivar los estilos visuales de una página HTML, agregue una etiqueta META a la <head> sección. Esta técnica también se aplica al contenido empaquetado como aplicaciones HTML (HTAs). Para desactivar los estilos visuales, la etiqueta META debe ser la siguiente:

<META HTTP-EQUIV="MSThemeCompatible" CONTENT="no">

Los estilos visuales pueden cambiar el diseño del contenido. Además, si establece ciertos atributos en controles HTML intrínsecos, como el ancho de un botón, es posible que la etiqueta del botón no se pueda leer en determinados estilos visuales.

Debe probar exhaustivamente el contenido mediante estilos visuales para determinar si la aplicación de estilos visuales tiene un efecto adverso en el contenido y el diseño.

Cuando no se aplican estilos visuales

Para evitar aplicar estilos visuales a una ventana de nivel superior, asigne a la ventana una región que no sea NULL (SetWindowRgn). El sistema supone que una ventana con una región que no es NULL es una ventana especializada que no usa estilos visuales. Una ventana secundaria asociada a una ventana de nivel superior que no sea de estilos visuales puede seguir aplicando estilos visuales aunque la ventana primaria no lo haga.

Si desea deshabilitar el uso de estilos visuales para todas las ventanas de la aplicación, llame a SetThemeAppProperties y no pase la marca STAP_ALLOW_NONCLIENT. Si una aplicación no llama a SetThemeAppProperties, los valores de marca asumidos se STAP_ALLOW_NONCLIENT | STAP_ALLOW_CONTROLS | STAP_ALLOW_WEBCONTENT. Los valores asumidos hacen que el área no cliente, los controles y el contenido web tengan aplicado un estilo visual.

Hacer que la aplicación sea compatible con versiones anteriores de Windows

Gran parte de la arquitectura de estilo visual está diseñada para facilitar el envío del producto en versiones anteriores de Windows que no admiten cambiar la apariencia de los controles. Al enviar una aplicación para más de un sistema operativo, tenga en cuenta lo siguiente:

• En las versiones de Windows anteriores a Windows 8, los estilos visuales están desactivados cuando el contraste alto está activado. Para admitir el contraste alto, una aplicación heredada que admite estilos visuales debe proporcionar una ruta de acceso de código independiente para dibujar correctamente los elementos de la interfaz de usuario en contraste alto. En Windows 8, el contraste alto forma parte de los estilos visuales; Sin embargo, una aplicación de Windows 8 (una que incluye el GUID de Windows 8 en la sección de compatibilidad de su manifiesto de aplicación) todavía debe proporcionar una ruta de acceso de código independiente para representar correctamente en contraste alto en Windows 7 una versión anterior.
• Si usa las características de ComCtl32.dll versión 6, como la vista de mosaico o el control de vínculo, debe controlar el caso en el que esos controles no estén disponibles en el equipo del usuario. ComCtl32.dll versión 6 no se puede redistribuir.
• Pruebe la aplicación para asegurarse de que no confía en las características de ComCtl32.dll versión 6 sin comprobar primero la versión actual.
• No vincule a UxTheme.lib.
• Escriba código de control de errores para instancias en las que los estilos visuales no funcionen según lo previsto.
• La instalación del manifiesto de la aplicación en versiones anteriores no afectará a la representación de controles.

Temas relacionados

Estilos visuales