Compartir a través de

Cómo: Adaptar soluciones de Office

  • Artículo

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

  • Proyectos de nivel de documento

Versión de Microsoft Office

  • Excel 2003

  • Excel 2007

Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto.

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.

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 Valores de configuración de Visual Studio.

Almacenar texto en un archivo de recursos

Para agregar texto a un archivo de recursos

  1. Abra el proyecto de Excel que desea localizar.

  2. En el menú Proyecto, elija Propiedades de <Nombre de proyecto>.

    Se abrirá el Diseñador de proyectos.

  3. En el Diseñador de proyectos, haga clic en Recursos para abrir el panel Recursos.

  4. En el cuadro combinado Categorías, seleccione Cadenas.

  5. 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.

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

  1. 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");

  2. 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

  1. 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.

  2. 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.

  3. 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

En soluciones de Visual Studio Tools para Office, tiene la posibilidad de agregar controles personalizados al panel de acciones. 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

  1. En el menú Ver, seleccione Ventana Propiedades.

  2. 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

Tareas

Tutorial: Adaptar formularios Windows Forms

Conceptos

Globalización y localización de las soluciones de Office

Otros recursos

Globalizar y localizar aplicaciones

Localizar aplicaciones