Cómo: Adaptar soluciones de Office

Artículo
08/10/2011

La localización consiste principalmente en la traducción de la interfaz de usuario de la aplicación En lugar de incorporar las cadenas al código de la aplicación, debería almacenarlas en un archivo separado. Puede almacenar cadenas para los elementos de la interfaz de usuario de Microsoft Office Excel en el archivo de recursos de ensamblado predeterminado del proyecto. El archivo se denomina MyResources.resx en proyectos de Visual Basic y Resources.resx en proyectos de C#. A continuación, las copias del archivo de recursos se pueden traducir a varios idiomas.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Excel 2007 y Excel 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Nota

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que tenga y la configuración que esté utilizando determinan estos elementos. Para obtener más información, vea Trabajar con valores de configuración.

Almacenar texto en un archivo de recursos

Para agregar texto a un archivo de recursos

Abra el proyecto de Excel que desea localizar.
En el menú Proyecto, elija Propiedades de <Nombre de proyecto>.

Se abrirá el Diseñador de proyectos.
En el Diseñador de proyectos, haga clic en Recursos para abrir el panel Recursos.
En el cuadro combinado Categorías, seleccione Cadenas.
Para cada cadena que desee adaptar, agregue un identificador único a la columna Nombre y el texto que se va a localizar en la columna Valor. Por ejemplo:

Nombre

Valor

ListCreateUnscheduledOrder

Cree un pedido sin programar

Nota

Puede utilizar la columna Comentario para proporcionar notas o instrucciones al traductor.

Nombre	Valor
ListCreateUnscheduledOrder	Cree un pedido sin programar

Recuperar texto de un archivo de recursos

Una vez agregada cada cadena al archivo de recursos, las cadenas se pueden cargar en tiempo de ejecución.

Para agregar un valor a una celda mediante un archivo de recursos

En el controlador de eventos Startup de Sheet1, agregue un control NamedRange a la celda A1.

Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange = _
    Me.Controls.AddNamedRange(Me.Range("A1"), "NamedRange1")

Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
    this.Controls.AddNamedRange(this.Range["A1", missing], "namedRange1");

Asigne un valor del archivo de recursos.

namedRange1.Value2 = My.Resources.ListCreateUnscheduledOrder

namedRange1.Value2 = Properties.Resources.ListCreateUnscheduledOrder;

Localizar el archivo de recursos

Para localizar un archivo de recursos

Copie el archivo de recursos y denomínelo con el código de la referencia cultural del idioma de destino. Por ejemplo, para crear un archivo que se localizará en japonés, copie el archivo Resources.resx y denomínelo Resources.ja.resx.
Haga que se traduzca el archivo de recursos a los idiomas que desee. Por ejemplo, haga que traduzcan las cadenas de Resources.ja.resx al japonés.
Agregue los archivos de recursos traducidos al proyecto para que el sistema de proyectos pueda compilar los archivos de recursos en ensamblados satélite.

Cargar recursos basados en el idioma de la interfaz de usuario de Office

Microsoft .NET Framework carga recursos basados en el idioma de la interfaz de usuario de Microsoft Windows. No obstante, normalmente las soluciones basadas en Office se escriben para cargar recursos basados en el idioma de la interfaz de usuario (IU) de Office. El primer ejemplo que sigue muestra cómo cargar recursos que coinciden con el idioma de la interfaz de usuario de Office independientemente de la versión de Office instalada. El segundo ejemplo muestra cómo reemplazar el idioma de la interfaz de usuario de Office y el comportamiento predeterminado de Microsoft .NET Framework.

Para cargar recursos basados en Office (varias versiones de lenguaje de Office)

Agregue el código siguiente al controlador del evento Startup del libro y cada una de las hojas de cálculo.

System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo( _
        Application.LanguageSettings.LanguageID( _
            Office.MsoAppLanguageID.msoLanguageIDUI))

System.Threading.Thread.CurrentThread.CurrentUICulture =
    new System.Globalization.CultureInfo(
        Application.LanguageSettings.get_LanguageID(
            Office.MsoAppLanguageID.msoLanguageIDUI));

Si no cuenta con varias versiones de lenguaje de Office, puede forzar que los recursos se carguen mediante la asignación del id. de la referencia cultural correspondiente a la propiedad CurrentCulture del objeto CultureInfo (o del subproceso actual). Esto puede ser de utilidad a efectos de depuración o como parte de código personalizado que permite a los usuarios seleccionar qué recursos desean cargar.

Para cargar recursos basados en Office (mediante el id. de la referencia cultural)

Agregue el código siguiente al controlador del evento Startup del libro y cada una de las hojas de cálculo. Este ejemplo pasa el id. de la referencia cultural para alemán (Alemania). Para obtener una lista de los id. de referencias culturales, vea CultureInfo.
```
System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo("de")
```
```
System.Threading.Thread.CurrentThread.CurrentUICulture = 
    new System.Globalization.CultureInfo("de");
```

Localizar controles personalizados

Puede agregar controles personalizados al recuadro de acciones en las soluciones de Office. Puede habilitar la localización de un control de usuario o un control del panel de acciones de la misma manera en que adaptaría un formulario Windows Forms. Para obtener más información, vea Tutorial: Adaptar formularios Windows Forms.

Para habilitar la localización de un control personalizado

En el menú Ver, seleccione Ventana Propiedades.
En el diseñador, seleccione el control de usuario o el control del panel de acciones y cambie la propiedad Localizable a true.

Vea también

Compartir a través de