Editor de recursos de Windows Forms (Winres.exe)

  • Artículo

El Editor de recursos de Windows Forms, Winres.exe, es una herramienta de diseño visual que ayuda a los expertos en localización a traducir los recursos de la interfaz de usuario (IU) de Windows Forms utilizados por los formularios. Los archivos .resx o .resources que se utilizan como entrada a Winres.exe se pueden crear utilizando un entorno de diseño visual como Microsoft Visual Studio. Para obtener información sobre la forma de implementar recursos en aplicaciones de .NET Framework, vea Recursos en aplicaciones.

winres resourceFile 
winres /?

Comentarios

Argumento Descripción

resourceFile

Archivo de recursos que se va a adaptar. Este archivo debe ser un archivo .resx o .resources de formularios Windows Forms generado por el diseñador de Visual Studio. Winres.exe no puede abrir archivos .resx o .resources genéricos.
Opción Descripción

/?

Muestra la sintaxis de comandos y opciones para la herramienta.

El estado de los elementos de la interfaz de usuario de un formulario de un proyecto de Windows Forms se almacena generalmente en archivos de recursos, que pueden ser archivos basados en XML con la extensión .resx o las correspondientes versiones binarias compiladas con la extensión .resources. Winres.exe es una herramienta que permite una edición limitada de cualquier tipo de archivo fuera del entorno de diseño de Visual Studio. Específicamente, permite las siguientes operaciones de edición:

  • Se pueden editar archivos de recursos de referencia cultural neutros o específicos para cambiar las propiedades de la interfaz de usuario del formulario o de sus controles, como el texto, el tamaño o la posición.

  • Los recursos de archivos de referencia cultural neutros o específicos se pueden generar desde el archivo de recursos predeterminado.

  • Un archivo de recursos de referencia cultural se puede guardar como otro archivo de recursos de referencia cultural. Por ejemplo, se puede guardar un archivo de recursos de inglés (EE. UU.) como un archivo de recursos de polaco. Normalmente, el nuevo archivo se editaría más adelante para ser compatible con la nueva referencia cultural.

Organización jerárquica de recursos para la localización
Organización jerárquica de recursos para la localización
Organización jerárquica de recursos para la localización
Organización jerárquica de recursos para la localización

Winres.exe no puede convertir un archivo .resx en su archivo .resources correspondiente; en su lugar utilice la herramienta Resgen.exe. Para obtener más información sobre Resgen.exe, vea Generador de archivos de recursos (Resgen.exe).

Winres.exe es una aplicación gráfica que vuelve a crear una versión en tiempo de diseño de un formulario Windows Forms a partir del archivo de recursos, sin tener acceso al código fuente. Winres.exe aloja el Diseñador de Windows Forms y la ventana Propiedades de Visual Studio. Estas características permiten la edición visual de un archivo .resources o .resx que contiene un formulario Windows Forms. Generalmente, los localizadores utilizan Winres.exe para editar etiquetas de controles y ajustar la ubicación y el tamaño de los mismos para albergar las etiquetas según la referencia cultural de destino.

Si Winres.exe no puede resolver el tipo de un control, crea un control PlaceHolder en el archivo .resx o .resources adaptado. El control PlaceHolder aparece en el formulario Windows Forms como una ventana sombreada. El tamaño y la posición de la ventana sombreada coinciden con el tamaño y la posición del control real. Todas las propiedades localizables disponibles para el control PlaceHolder aparecen en la ventana Propiedades. Los cambios que se realicen en el control PlaceHolder se guardarán para el control real.

Winres.exe frente a Visual Studio

En general, antes de empezar a adaptar formularios Windows Forms de una aplicación, se debe decidir si se desea utilizar Visual Studio .NET o Winres.exe como herramienta de localización. La compatibilidad de la versión, como se describe más delante, puede impedir que se cambie de una herramienta a otra.

Visual Studio tiene la ventaja de que se puede utilizar tanto para desarrollar una aplicación como para adaptarla. Para adaptar un formulario, una vez completado su desarrollo, establezca la propiedad LocalizableAttribute (la propiedad Localizable en el editor de propiedades) en true y cambiar la propiedad Language a la referencia cultural de destino que desee. A continuación, se han de editar las cadenas y ajustar la ubicación y el tamaño de los controles para que las cadenas quepan en ellos dependiendo de la referencia cultural de destino. Cuando se guarda el archivo .resx adaptado, Visual Studio escribe en el mismo las propiedades localizables (propiedades que han cambiado en la referencia cultural de destino). Visual Studio crea automáticamente un ensamblado satélite para el archivo .resx adaptado en la posición de directorio correcta. Tutorial: Adaptar formularios Windows Forms
Tutorial: Adaptar formularios Windows Forms
Tutorial: Adaptar formularios Windows Forms
Tutorial: Adaptar formularios Windows Forms
Tutorial: Adaptar formularios Windows Forms

Aunque Visual Studio proporciona un entorno de desarrollo y localización integrado, Winres.exe es la herramienta que se recomienda utilizar si la localización va a ser realizada por localizadores de terceros. Como Winres.exe es sólo una herramienta de localización, proporciona una separación más nítida del código de una aplicación de los formularios que se van a adaptar, lo que resulta más práctico para la administración de proyectos grandes.

Utilizar Winres.exe

Para adaptar mediante Winres.exe, primero se debe desarrollar una aplicación con un diseñador visual, como el diseñador de formularios de Visual Studio. Una vez completado el desarrollo, se ha de establecer el atributo LocalizableAttribute del formulario (propiedad Localizable en el editor de propiedades) a true y, a continuación, pasar el archivo .resx para la referencia cultural predeterminada a un localizador de terceros. Este archivo .resx contiene información adicional que Winres.exe usa para crear una nueva versión en tiempo de diseño del formulario original.

Nota de precauciónPrecaución

Winres.exe no se puede utilizar para editar el archivo de recursos predeterminado. Winres.exe interpreta todas las propiedades cambiadas como propiedades adaptadas y las guarda en el archivo de recursos de la referencia cultural de destino.

Las versiones finales de los archivos de recursos de referencia cultural se pueden utilizar para crear versiones localizadas de la aplicación. Para obtener más información, vea Recursos en aplicaciones.

La versión 2.0 de Winres.exe tiene las siguientes características y funciones:

  • Winres puede funcionar en modo Single File (SFM) o en modo Visual Studio File (VSFM). SFM es el modo heredado donde la información completa sobre el formulario y su contenido se almacena en el archivo de recursos. VSFM sólo almacena los cambios culturales en el archivo de recursos.

  • Una ventana de informe de errores, acoplada en la parte inferior izquierda de la ventana principal, se ha agregado a la interfaz.

  • Se pueden buscar duplicados de las teclas de acceso rápido: en el menú Formato, haga clic en el comando Comprobar las teclas de acceso rápido.

Compatibilidad de versiones

Winres.exe ha cambiado para hacerse compatible del mismo modo que el formato de archivos de recursos cambió entre Visual Studio .NET 2002 y Visual Studio 2005. Por consiguiente, como norma general, deberá utilizar la versión de Winres.exe que se comercializó con la versión de .NET Framework que está utilizando para crear la aplicación. En la siguiente tabla se identifican las versiones compatibles.

Visual Studio .NET Framework Winres.exe

Visual Studio .NET 2002

1.0

1.0

Visual Studio .NET 2003

1.1

1.1

Visual Studio 2005

2.0

2.0

Si intenta abrir un archivo de recursos anterior con la versión 2.0 de Winres.exe, se le solicitará que actualice el formato del archivo para que sea compatible con la versión 2.0 de .NET Framework.

En las versiones de .NET Framework anteriores a la versión 2.0, Winres.exe y el diseñador de formularios de Visual Studio han creado archivos de recursos de referencia cultural neutra y específica que no son compatibles. Por consiguiente, una vez iniciado el proceso de la localización, tenía que seguir utilizando sólo la misma herramienta. Sin embargo, con la versión 2.0 de Winres.exe, se agregó el modo Visual Studio File (VSFM). Como su nombre implica, un archivo de recursos guardado en este modo de compatibilidad puede editarse con cualquier herramienta.

Nota

Aunque VSFM tiene la ventaja de ser compatible con Visual Studio puesto que almacena sólo los valores que han cambiado en el archivo de recursos, Winres.exe requiere que los elementos primarios del archivo de recursos actual se encuentren en el mismo directorio. Por ejemplo, la edición de TestApp.de-DE.resources, un archivo de recursos de alemán de Alemania, requiere la presencia del archivo de recursos predeterminado, TestApp.resx, y posiblemente del archivo de recursos de referencia cultural neutra, TestApp.de.resources.

Ejemplos

Para adaptar un archivo .resx o .resources asociado a un formulario

  1. Escriba winres en el símbolo del sistema para ejecutar Winres.exe.

  2. Para abrir los recursos predeterminados de un formulario que desee adaptar, haga clic en el comando Abrir del menú Archivo y desplácese al archivo que desee abrir.

    o bien,

    Especifique el archivo que desee abrir en la línea de comandos al iniciar Winres.exe.

    El siguiente comando inicia Winres.exe y carga el formulario asociado a TestApp.resx en el diseñador de formularios.

    winres TestApp.resx

    El siguiente comando inicia Winres.exe y carga el formulario asociado a TestApp.resources en el diseñador de formularios.

    winres TestApp.resources

    Nota

    Si el formulario cuyos recursos está editando es un formulario heredado, tanto el ensamblado que contiene el formulario heredado como el ensamblado que contiene el formulario que hereda (derivado) deben estar registrados en la caché de ensamblados global (GAC), o deben residir en el mismo directorio que WinRes.exe. Para obtener más información sobre la instalación de los componentes de .NET Framework en la GAC, vea Caché de ensamblados global.

  3. Seleccione los controles en el formulario y cambie la propiedad Text y otras propiedades para reflejar la referencia cultural adaptada y su lenguaje. Desplace o cambie el tamaño de los controles lo necesario para que quepa el texto adaptado.

  4. Para guardar la versión adaptada del archivo .resx o .resources, haga clic en el icono Guardar o en el mismo comando en el menú Archivo. La herramienta mostrará la ventana Seleccionar referencia cultural.

  5. Seleccione la referencia cultural adecuada y el modo de archivo, y haga clic en Aceptar. La herramienta guardará el archivo, utilizando la convención de nomenclatura que prevé el motor en tiempo de ejecución para archivos de recursos adaptados. Por ejemplo, si adapta TestApp.resources para alemán de Alemania, la herramienta guardará el archivo como TestApp.de-DE.resources. Si adapta TestApp.resx para alemán de Alemania, la herramienta guardará el archivo como TestApp.de-DE.resx. Para obtener más información sobre convenciones de nomenclatura, vea Empaquetar e implementar recursos. Para obtener una lista de los nombres de referencias culturales predefinidos que utiliza el motor en tiempo de ejecución, vea la CultureInfo Class.

Vea también

Referencia

Herramientas de .NET Framework
LocalizableAttribute
CultureInfo
ResourceManager
ResourceReader
ResourceWriter

Conceptos

Recursos en aplicaciones

Otros recursos

Codificación y localización