Páginas de propiedades (C++)

Artículo
10/07/2008

Actualización: noviembre 2007

La página de propiedades de un proyecto es un elemento de la interfaz de usuario de Visual Studio que permite especificar y aplicar una configuración a sus proyectos.

Para abrir una página de propiedades, seleccione un proyecto y haga clic en Propiedades en el menú de acceso directo, o bien haga clic en Propiedades en el menú Proyecto. Cuando se especifican valores en el cuadro de diálogo Páginas de propiedades, éstos se aplican al proyecto o los proyectos seleccionados en el Explorador de soluciones.

Puede especificar y aplicar la configuración de proyecto a todas las configuraciones de generación, o bien especificar unas propiedades de proyecto independientes para cada configuración de generación. Por ejemplo, puede especificar valores para la configuración de la Versión de lanzamiento que no sean aplicables a la configuración de la Versión de depuración.

Las páginas de propiedades son dinámicas, y las páginas que aparecen dependen del tipo de archivos del proyecto. Por ejemplo, si el proyecto no contiene un archivo .idl, la página de propiedades de IDL no aparecerá en el cuadro de diálogo Páginas de propiedades.

Para obtener más información, vea Cómo: Especificar propiedades de proyecto con páginas de propiedades.

Propiedades predeterminadas y propiedades modificadas

Algunos valores de propiedades aparecen en negrita, lo que significa que su valor ha cambiado. El valor predeterminado de una propiedad de proyecto (es decir, cuando el nodo del proyecto está seleccionado en el Explorador de soluciones) suele ser el valor predeterminado de esa propiedad para la herramienta. Por ejemplo, en un proyecto Win32, en la página de propiedades Generación de código, el valor de la propiedad Habilitar agrupación de cadenas está establecido inicialmente en No (no aparece en negrita). Esto significa que el valor No concuerda con el valor predeterminado del proyecto. Si desea utilizar CL.exe en la línea de comandos, el modificador /GF no estará activo a menos que lo haya especificado.

Si cambia el valor de una propiedad (o lo cambia el asistente para aplicaciones), el valor aparecerá en negrita. Por ejemplo, en la misma página de propiedades Generación de código, el modificador /RTC1 sí está activo para la propiedad Comprobaciones básicas en tiempo de ejecución. En la línea de comandos, el modificador /RTC1 no estará activo de manera predeterminada; en este caso, el asistente para aplicaciones modificó el valor predeterminado de la propiedad para el proyecto.

Existe un subconjunto de valores predeterminados del proyecto expuesto y disponible para su modificación. Para obtener más información, vea la sección de valores predeterminados de proyecto en Página de propiedades General (Proyecto).

Restablecer valores de propiedades

Al mostrar el cuadro de diálogo Páginas de propiedades de un proyecto y al seleccionar el nodo del proyecto en el Explorador de soluciones, también tendrá la opción de seleccionar para cada propiedad <heredar de valores predeterminados del proyecto>.

Haga clic en Aplicar para asegurarse de que se actualiza la vista del cuadro de diálogo Páginas de propiedades con las opciones más recientes al restablecer el valor de una propiedad al valor predeterminado del proyecto.

Al mostrar el cuadro de diálogo Páginas de propiedades de un proyecto y al seleccionar un archivo en el Explorador de soluciones, los valores de propiedades que aparezcan en negrita indicarán que se modificó el valor de esa propiedad para el archivo. Por consiguiente, para cada propiedad también tendrá la opción de seleccionar <heredar del proyecto>. Si hay muchos archivos con valores de propiedades modificados, aumentará el tiempo necesario para generar el proyecto.

Los valores predeterminados de un proyecto son, en gran parte, valores predeterminados para el sistema (plataforma). Algunos valores predeterminados del proyecto provienen de las hojas de estilo que se aplican cuando se actualizan propiedades en la sección Valores predeterminados del proyecto de la página general de configuración del proyecto (vea Página de propiedades General (Proyecto)).

Escribir valores definidos por el usuario

Otras propiedades requieren que especifique sus valores. Algunas de estas propiedades toman uno o más valores (propiedades múltiples) y otras toman un solo valor (propiedades simples).

Es posible escribir directamente en la columna de la derecha de la página de propiedades. Debe separar los valores con signos de punto y coma. Utilice únicamente caracteres alfabéticos y numéricos para estas propiedades. No se realizará comprobación de errores para estos valores.

También se puede seleccionar <Edición...> en la lista desplegable (para las propiedades simples) o el botón Examinar (para una propiedad múltiple seleccionada). Esto abre un cuadro de diálogo donde se puede escribir el valor o los valores de la propiedad. El título de este cuadro de diálogo será igual al nombre de la propiedad que se está editando. Para las propiedades múltiples, escriba un valor por línea con un retorno de carro después de cada valor.

Los cuadros de edición para propiedades múltiples tendrán una casilla con la etiqueta heredar del proyecto (para un archivo) o heredar de valores predeterminados del proyecto (para un proyecto). Esta casilla está activada de manera predeterminada; así, la propiedad puede heredar valores del proyecto, si se selecciona un archivo, o los valores predeterminados del proyecto, si se selecciona el proyecto en el Explorador de soluciones.

Tenga en cuenta que los valores para propiedades múltiples que se muestran en el cuadro de diálogo de página de propiedades reflejan sólo las configuraciones de las propiedades del nivel actual. Por ejemplo, si hay un archivo seleccionado en el Explorador de soluciones y selecciona la propiedad Definiciones del preprocesador de C/C++, la página de propiedades no mostrará ninguna definición de preprocesador en el nivel de proyecto. No obstante, si abre el cuadro de edición de propiedad múltiple, podrá ver todos los valores heredados para la propiedad.

Si utiliza el Modelo de proyecto de Visual C++, tenga en cuenta que este comportamiento se aplica también a los objetos de archivos y proyectos. Es decir, cuando consulte los valores de una propiedad en el nivel de archivo, no obtendrá los valores para esa misma propiedad en el nivel de proyecto; deberá obtener explícitamente los valores de la propiedad en el nivel de proyecto. Tenga en cuando que algunos de los valores heredados de una propiedad pueden proceder de una hoja de estilo, a la que en esta versión no puede obtener acceso mediante programación.

Macros $(Inherit) y $(NoInherit)

Tenga en cuenta que puede utilizar dos macros para propiedades en las que especifique valores definidos por el usuario:

$(Inherit)
$(NoInherit)

Desactivar la casilla (por ejemplo, heredar de valores predeterminados del proyecto) equivale a especificar $(NoInherit); es más sencillo utilizar la casilla. Si especifica $(NoInherit), es muy posible que desee especificar sus propios valores.

Independientemente de la configuración de la casilla heredar del proyecto (o heredar de valores predeterminados del proyecto), si utiliza alguna de estas macros en el cuadro de edición, se omitirá la configuración de la casilla.

Si utiliza $(NoInherit) en una propiedad, piense si alguno de los valores predeterminados del proyecto podría afectar a la propiedad. Si puede afectar, podría reemplazar sin querer un valor predeterminado del proyecto que haya especificado.