Cómo incluir recursos en tiempo de compilación (C++)

Artículo
06/16/2023

De forma predeterminada, todos los recursos se encuentran en un archivo de script de recursos (.rc), pero hay muchas razones para colocar recursos en un archivo distinto del archivo .rc principal:

Para agregar comentarios a instrucciones de recursos que no se eliminen al guardar el archivo .rc.
Para incluir recursos que ya se desarrollaron y se probaron y que no necesitan más modificaciones. Los editores de recursos no podrán editar los archivos que se incluyan sin una extensión .rc.
Para incluir recursos que se usan en proyectos diferentes o que forman parte de un sistema de control de versiones de código fuente. Estos recursos deben existir en una ubicación central donde las modificaciones afectarán a todos los proyectos.
Para incluir recursos (por ejemplo, recursos RCDATA) que se encuentran en un formato personalizado. Los recursos RCDATA tienen requisitos especiales, según los cuales no se puede usar una expresión como un valor para el campo nameID.

Si tiene secciones en los archivos .rc que cumplen alguna de estas condiciones, coloque las secciones en uno o varios archivos .rc independientes e inclúyalos en el proyecto con el cuadro de diálogo Archivos de inclusión de recursos.

Archivos de inclusión de recursos

Puede agregar recursos de otros archivos al proyecto actual en tiempo de compilación si los enumera en el cuadro Directivas de tiempo de compilación del cuadro de diálogo Archivos de inclusión de recursos. Use el cuadro de diálogo Archivos de inclusión de recursos para cambiar el hábito del entorno del proyecto de almacenar todos los recursos en el archivo .rc del proyecto y todos los símbolos en Resource.h.

Para empezar, abra el cuadro de diálogo Archivos de inclusión de recursos. Para ello, haga clic con el botón derecho en un archivo .rc en Vista de recursos, seleccione Archivos de inclusión de recursos y anote las propiedades siguientes:

Propiedad	Descripción
Archivo de encabezado de símbolos	Permite cambiar el nombre del archivo de encabezado donde se almacenan las definiciones de los símbolos de los archivos de recursos. Para obtener más información, consulte Para cambiar el nombre del archivo de encabezado de símbolos.
Directivas de símbolos de solo lectura	Permite incluir archivos de encabezado cuyos símbolos no deben modificarse. Por ejemplo, los archivos de símbolos que se van a compartir con otros proyectos. Esto también puede incluir archivos .h de MFC. Para obtener más información, consulte Para incluir símbolos compartidos (de solo lectura) o símbolos calculados.
Directivas de tiempo de compilación	Permite incluir archivos de recursos que se crean y editan con independencia de los recursos del archivo principal de recursos, que contienen directivas de tiempo de compilación (como las que incluyen recursos de forma condicional) o que contienen recursos en un formato personalizado. También se puede usar el cuadro Directivas de tiempo de compilación para incluir archivos de recursos de MFC estándar.

Nota:

Las entradas de estos cuadros de texto aparecen en el archivo .rc marcadas respectivamente por TEXTINCLUDE 1, TEXTINCLUDE 2 y TEXTINCLUDE 3. Para obtener más información, consulte TN035: Uso de varios archivos de recursos y archivos de encabezado con Visual C++.

Una vez realizados los cambios en el archivo de recursos mediante el cuadro de diálogo Archivos de inclusión de recursos, debe cerrar el archivo .rc y volver a abrirlo para que los cambios surtan efecto.

Para incluir recursos en el proyecto en tiempo de compilación

Sitúe los recursos en un archivo de script de recursos con un nombre de archivo único. No use projectname.rc, ya que este es el nombre de archivo que se usa para el archivo de script de recursos principal.
Haga clic con el botón derecho en el archivo .rc en Vista de recursos y seleccione Archivos de inclusión de recursos.
En el cuadro Directivas de tiempo de compilación, agregue la directiva de compilador #include para incluir el nuevo archivo de recursos en el archivo de recursos principal del entorno de desarrollo.

Los recursos de los archivos incluidos de esta manera solo forman parte del archivo ejecutable en tiempo de compilación y no están disponibles para la edición o la modificación cuando se trabaja en el archivo .rc principal del proyecto. Los archivos .rc incluidos deben abrirse por separado y los editores de recursos no podrán editar los archivos incluidos sin la extensión .rc.

Para especificar directorios de inclusión para un archivo de recursos (.rc) determinado

Haga clic con el botón derecho en el archivo .rc en el Explorador de soluciones y seleccione Propiedades.
Seleccione el nodo Recursos en el panel izquierdo y especifique los directorios de inclusión adicionales en la propiedad Directorios de inclusión adicionales.

Para buscar símbolos en recursos:

Vaya al menú Editar>Buscar símbolo.

Sugerencia

Para usar expresiones regulares en la búsqueda, seleccione Buscar en archivos en el menú Editar, en vez de Buscar símbolo. Active la casilla Usar expresiones regulares en el cuadro de diálogo Buscar y, en el cuadro Buscar, puede elegir una expresión de búsqueda regular en la lista desplegable. Si selecciona una expresión de esta lista, se usa como texto de búsqueda en el cuadro Buscar.
En cuadro Buscar, seleccione una cadena de búsqueda anterior en la lista desplegable o escriba la tecla de aceleración que quiere buscar (por ejemplo, ID_ACCEL1).
Elija cualquiera de las opciones Buscar y seleccione Buscar siguiente.

Nota:

No se pueden buscar símbolos en los recursos binarios, de acelerador o de cadena.

Requisitos

Win32

Consulte también

Archivos de recursos
Cómo crear recursos
Cómo administrar recursos

Compartir a través de