次の方法で共有


メニュー コマンドをローカライズする

VSPackage に対してローカライズされた .vsct ファイルとローカライズされた .resx ファイルを作成し、プロジェクト ファイルを更新して変更内容を反映することによって、メニューとツールバーのコマンド用にローカライズされたテキストを提供することができます。

インストール エクスペリエンスをローカライズする方法の詳細については、「VSIX パッケージをローカライズする」を参照してください。

コマンド名をローカライズする

VSPackage では、メニュー コマンドとツールバー ボタンは .vsct ファイルで定義されています。

  1. ソリューション エクスプローラーで、.vsct ファイルの名前を filename.vsct から filename.en-US.vsct に変更します。

  2. ローカライズされる言語ごとに filename.en-US.vsct のコピーを作成します。

    各コピーに filename.{Locale}.vsct という名前を指定します。ここで、{Locale} は特定のカルチャ名です。 カルチャ名の値の一覧については、「Microsoft によって割り当てられているロケール ID」を参照してください。

    これらの filename.Locale.vsct ファイルには、パッケージのローカライズされたメニュー テキストが含まれています。

  3. テキストをローカライズするために、それぞれの filename.Locale.vsct テキストを開きます。

    1. 特定の言語に合わせて ButtonText 要素の値を変更します。

    2. ローカライズされたアイコンを提供する場合は、ターゲット ファイルを指すように Bitmap 値を変更します。

      次の例では、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>
    

その他のテキスト リソースをローカライズする

コマンド名以外のテキスト リソースは、リソース (.resx) ファイルで定義されています。

  1. VSPackage.resx の名前を VSPackage.en-US.resx に変更します。

  2. ローカライズされる言語ごとに VSPackage.en-US.resx ファイルのコピーを作成します。

    各コピーに VSPackage.{Locale}.resx という名前を指定します。ここで、{Locale} は特定のカルチャ名です。

  3. Resources.resx の名前を Resources.en-US.resx に変更します。

  4. ローカライズされる言語ごとに Resources.en-US.resx ファイルのコピーを作成します。

    各コピーに Resources.{Locale}.resx という名前を指定します。ここで、{Locale} は特定のカルチャ名です。

  5. .resx ファイルを開き、特定の言語とカルチャに合わせて文字列値を変更します。 次の例は、ツール ウィンドウのタイトル バーのローカライズされたリソース定義を示しています。

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

ローカライズされたリソースをプロジェクトに組み込む

ローカライズされたリソースを組み込むには、assemblyinfo.cs ファイルとプロジェクト ファイルを変更する必要があります。

  1. ソリューション エクスプローラー[プロパティ] ノードから、エディターで assemblyinfo.cs または assemblyinfo.vb を開きます。

  2. 次のエントリを追加します。

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

    これにより、既定の言語として英語 (米国) が設定されます。

  3. プロジェクトをアンロードします。

  4. エディターでプロジェクト ファイルを開きます。

  5. ルートの Project 要素に、既定の言語に一致する UICulture 要素を持つ PropertyGroup 要素を追加します。

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

    これにより、Windows Presentation Foundation (WPF) コントロールの既定の UI カルチャとして英語 (米国) が設定されます。

  6. EmbeddedResource 要素を含む ItemGroup 要素を探します。

  7. VSPackage.en-US.resx を呼び出す EmbeddedResource 要素で、次のように、ManifestResourceName 要素を、VSPackage.en-US.Resources に設定された LogicalName 要素に置き換えます。

    <EmbeddedResource Include="VSPackage.en-US.resx">
      <MergeWithCTO>true</MergeWithCTO>
      <LogicalName>VSPackage.en-US.Resources</LogicalName>
    </EmbeddedResource>
    
  8. ローカライズされる言語ごとに、VsPackage.en-USEmbeddedResource 要素をコピーし、コピーの Include 属性と LogicalName 要素をターゲットのロケールに設定します。

  9. 次の例に示すように、ローカライズされた各 VSCTCompile 要素に、Menus.ctmenu を指す ResourceName 要素を追加します。

    <ItemGroup>
      <VSCTCompile Include="LocalizedPackage.es-ES.vsct">
        <ResourceName>Menus.ctmenu</ResourceName>
      </VSCTCompile>
    </ItemGroup>
    
  10. プロジェクト ファイルを保存してプロジェクトを再度読み込みます。

  11. プロジェクトをビルドします。

    これにより、各言語のメイン アセンブリとリソース アセンブリが作成されます。 デプロイ プロセスのローカライズの詳細については、「VSIX パッケージをローカライズする」を参照してください