Lokalizovat příkazy nabídky

  • Článek

Lokalizovaný text pro příkazy nabídek a panelů nástrojů můžete zadat tak, že vytvoříte lokalizované soubory .vsct a lokalizované soubory .resx pro balíček VSPackage a pak aktualizujete soubory projektu tak, aby zahrnovaly změny.

Informace o tom, jak lokalizovat prostředí instalace, naleznete v tématu Lokalizace balíčků VSIX.

Lokalizace názvů příkazů

V balíčku VSPackages jsou příkazy nabídky a tlačítka panelu nástrojů definovány v souboru .vsct .

  1. V Průzkumník řešení změňte název souboru .vsct z názvu souboru.vsct na název souboru.en-US.vsct.

  2. Vytvořte kopii souboru.en-US.vsct pro každý lokalizovaný jazyk.

    Pojmenujte každý název souboru kopírování .{ Národní prostředí}.vsct, kde {Locale} je konkrétní název jazykové verze. Seznam hodnot názvu jazykové verze najdete v tématu ID národního prostředí přiřazené Microsoftem.

    Tento název souboru. Soubory locale.vsct budou obsahovat lokalizovaný text nabídky pro váš balíček.

  3. Otevřete každý název souboru. Soubor locale.vsct pro lokalizaci textu

    1. Upravte hodnoty elementu ButtonText podle potřeby pro konkrétní jazyk.

    2. Pokud zadáte lokalizované ikony, upravte hodnoty Bitmap tak, aby odkazy na cílové soubory.

      Následující příklad ukazuje text anglického a španělského tlačítka pro příkaz k otevření okna nástroje Family Tree Explorer.

      [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>

Lokalizace jiných textových prostředků

Textové prostředky jiné než názvy příkazů jsou definovány v souborech prostředků (.resx).

  1. Přejmenujte VSPackage.resx na VSPackage.en-US.resx.

  2. Vytvořte kopii souboru VSPackage.en-US.resx pro každý lokalizovaný jazyk.

    Pojmenujte každou kopii balíčku VSPackage.{ Locale}.resx, kde {Locale} je konkrétní název jazykové verze.

  3. Přejmenujte Resources.resx na Resources.en-US.resx.

  4. Vytvořte kopii souboru Resources.en-US.resx pro každý lokalizovaný jazyk.

    Pojmenujte každou kopii zdroje.{ Locale}.resx, kde {Locale} je konkrétní název jazykové verze.

  5. Otevřete každý soubor .resx a upravte řetězcové hodnoty podle potřeby pro konkrétní jazyk a jazykovou verzi. Následující příklad ukazuje definici lokalizovaného prostředku pro záhlaví okna nástroje.

    [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>

Začlenění lokalizovaných zdrojů do projektu

Soubor assemblyinfo.cs a soubor projektu je nutné upravit tak, aby zahrnoval lokalizované prostředky.

  1. Z uzlu Vlastnosti v Průzkumník řešení otevřete v editoru soubor assemblyinfo.cs nebo assemblyinfo.vb.

  2. Přidejte následující položku.

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

    Nastaví se angličtina v USA jako výchozí jazyk.

  3. Uvolněte projekt.

  4. Otevřete soubor projektu v editoru.

  5. V kořenovém Project elementu přidejte PropertyGroup prvek s elementem UICulture , který odpovídá vašemu výchozímu jazyku.

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

    Tato možnost nastaví angličtinu v USA jako výchozí jazykovou verzi uživatelského rozhraní pro ovládací prvky Windows Presentation Foundation (WPF).

  6. ItemGroup Vyhledejte prvek, který obsahuje EmbeddedResource elementy.

  7. V elementu EmbeddedResource , který volá VSPackage.en-US.resx, nahraďte ManifestResourceName prvek elementem LogicalName , který je nastaven na VSPackage.en-US.Resources, následujícím způsobem:

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

  8. Pro každý lokalizovaný jazyk zkopírujte EmbeddedResource element pro VsPackage.en-USa nastavte Include atribut a LogicalName prvku kopie na cílové národní prostředí.

  9. Do každého lokalizovaného VSCTCompile prvku přidejte ResourceName prvek, který odkazuje na Menus.ctmenu, jak je znázorněno v následujícím příkladu:

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

  10. Uložte soubor projektu a znovu načtěte projekt.

  11. Sestavte projekt.

    Tím se vytvoří hlavní sestavení a sestavení prostředků pro každý jazyk. Informace o lokalizaci procesu nasazení najdete v tématu Lokalizace balíčků VSIX.

Související obsah