Compartir a través de

Localización de comandos de menú

  • Artículo

Puede proporcionar texto localizado para los comandos de menú y barra de herramientas creando archivos .vsct localizados y archivos .resx localizados para vsPackage y, a continuación, actualizando los archivos de proyecto para incorporar los cambios.

Para obtener información sobre cómo localizar la experiencia de instalación, vea Localizar paquetes VSIX.

Localizar nombres de comandos

En VSPackages, los comandos de menú y los botones de la barra de herramientas se definen en el archivo .vsct .

  1. En Explorador de soluciones, cambie el nombre del archivo .vsct de filename.vsct a filename.en-US.vsct.

  2. Realice una copia de filename.en-US.vsct para cada idioma localizado.

    Asigne un nombre a cada nombre de archivo de copia .{ Locale}.vsct, donde {Locale} es un nombre de referencia cultural determinado. Para obtener una lista de valores de nombre de referencia cultural, consulte Identificadores de configuración regional asignados por Microsoft.

    Este nombre de archivo. Los archivos Locale.vsct contendrán el texto del menú localizado del paquete.

  3. Abra cada nombre de archivo. Archivo Locale.vsct para localizar el texto.

    1. Modifique los valores del elemento ButtonText según corresponda para el idioma determinado.

    2. Si proporcionará iconos localizados, modifique los valores de mapa de bits para que apunten a los archivos de destino.

      En el ejemplo siguiente se muestra el texto del botón inglés y español de un comando para abrir una ventana de herramientas del Explorador de árboles de familia.

      [FamilyTree.en-US.vsct]

    <Button guid="guidLocalizedPackageCmdSet" id="cmdidFamilyTree" priority="0x0100" type="Button">
  <Parent guid="guidSHLMainMenu" id="IDG_VS_WNDO_OTRWNDWS1"/>
  <Icon guid="guidImages" id="bmpPic2" />
  <Strings>
    <CommandName>cmdidFamilyTree</CommandName>
    <ButtonText>Family Tree Explorer</ButtonText>
  </Strings>
</Button>

    [FamilyTree.es-ES.vsct]

    <Button guid="guidLocalizedPackageCmdSet" id="cmdidFamilyTree" priority="0x0100" type="Button">
  <Parent guid="guidSHLMainMenu" id="IDG_VS_WNDO_OTRWNDWS1"/>
  <Icon guid="guidImages" id="bmpPic2" />
  <Strings>
    <CommandName>cmdidFamilyTree</CommandName>
    <ButtonText>Explorar el arbol genealogico</ButtonText>
  </Strings>
</Button>

Localizar otros recursos de texto

Los recursos de texto distintos de los nombres de comando se definen en los archivos de recursos (.resx).

  1. Cambie el nombre de VSPackage.resx a VSPackage.en-US.resx.

  2. Realice una copia del archivo VSPackage.en-US.resx para cada idioma localizado.

    Asigne a cada copia el nombre VSPackage.{ Locale}.resx, donde {Locale} es un nombre de referencia cultural determinado.

  3. Cambie el nombre de Resources.resx a Resources.en-US.resx.

  4. Realice una copia del archivo Resources.en-US.resx para cada idioma localizado.

    Asigne a cada copia el nombre Resources.{ Locale}.resx, donde {Locale} es un nombre de referencia cultural determinado.

  5. Abra cada archivo .resx para modificar los valores de cadena según corresponda para el idioma y la referencia cultural concretos. En el ejemplo siguiente se muestra la definición de recursos localizada para la barra de título de una ventana de herramientas.

    [Resources.en-US.resx]

    <data name="ToolWindowTitle" xml:space="preserve">
  <value>Family Tree Explorer</value>
</data>

    [Resources.es-ES.resx]

    <data name="ToolWindowTitle" xml:space="preserve">
  <value>Explorador del arbol genealogico</value>
</data>

Incorporación de recursos localizados en el proyecto

Debe modificar el archivo assemblyinfo.cs y el archivo de proyecto para incorporar los recursos localizados.

  1. En el nodo Propiedades de Explorador de soluciones, abra assemblyinfo.cs o assemblyinfo.vb en el editor.

  2. Agregue la entrada siguiente.

    [assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]

    Esto establece inglés de EE. UU. como idioma predeterminado.

  3. Descargue el proyecto.

  4. Abra el archivo del proyecto en el editor.

  5. En el elemento raíz Project , agregue un PropertyGroup elemento con un UICulture elemento que coincida con el idioma predeterminado.

    <PropertyGroup>
  <UICulture>en-US</UICulture>
</PropertyGroup>

    Esto establece inglés de EE. UU. como la referencia cultural de interfaz de usuario predeterminada para los controles de Windows Presentation Foundation (WPF).

  6. Busque el ItemGroup elemento que contiene EmbeddedResource elementos.

  7. En el EmbeddedResource elemento que llama a VSPackage.en-US.resx, reemplace el ManifestResourceName elemento por un LogicalName elemento establecido VSPackage.en-US.Resourcesen , como se indica a continuación:

    <EmbeddedResource Include="VSPackage.en-US.resx">
  <MergeWithCTO>true</MergeWithCTO>
  <LogicalName>VSPackage.en-US.Resources</LogicalName>
</EmbeddedResource>

  8. Para cada idioma localizado, copie el EmbeddedResource elemento para VsPackage.en-USy establezca el atributo Include y el elemento LogicalName de la copia en la configuración regional de destino.

  9. Para cada elemento localizado, agregue un ResourceName elemento que apunte VSCTCompile a Menus.ctmenu, como se muestra en el ejemplo siguiente:

    <ItemGroup>
  <VSCTCompile Include="LocalizedPackage.es-ES.vsct">
    <ResourceName>Menus.ctmenu</ResourceName>
  </VSCTCompile>
</ItemGroup>

  10. Guarde el archivo del proyecto y vuelva a cargar el proyecto.

  11. Compile el proyecto.

    Esto crea un ensamblado principal y ensamblados de recursos para cada lenguaje. Para obtener información sobre cómo localizar el proceso de implementación, consulte Localización de paquetes VSIX.

Contenido relacionado