Aracılığıyla paylaş

Menü komutlarını yerelleştir

  • Makale

VSPackage'ınız için yerelleştirilmiş .vsct dosyaları ve yerelleştirilmiş .resx dosyaları oluşturup ardından proje dosyalarını değişiklikleri içerecek şekilde güncelleştirerek menü ve araç çubuğu komutları için yerelleştirilmiş metin sağlayabilirsiniz.

Yükleme deneyimini yerelleştirme hakkında bilgi için bkz . VSIX paketlerini yerelleştirme.

Komut adlarını yerelleştirme

VSPackage'larda menü komutları ve araç çubuğu düğmeleri .vsct dosyasında tanımlanır.

  1. Çözüm Gezgini dosyaadı.vsct dosyasından .vsct dosyasının adını filename.en-US.vsct olarak değiştirin.

  2. Her yerelleştirilmiş dil için filename.en-US.vsct dosyasının bir kopyasını oluşturun.

    Her kopya dosya adını adlandırın.{ Locale}.vsct; burada {Locale} belirli bir kültür adıdır. Kültür adı değerlerinin listesi için bkz . Microsoft tarafından atanan Yerel Ayar Kimlikleri.

    Bu dosya adı. Locale.vsct dosyaları paketinizin yerelleştirilmiş menü metnini içerir.

  3. Her dosya adını açın. Metni yerelleştirmek için Locale.vsct dosyası.

    1. ButtonText öğesi değerlerini belirli bir dile uygun şekilde değiştirin.

    2. Yerelleştirilmiş simgeler sağlayacaksanız, Bit Eşlem değerlerini hedef dosyalara işaret edecek şekilde değiştirin.

      Aşağıdaki örnekte, aile ağacı gezgini araç penceresini açmak için bir komutun İngilizce ve İspanyolca düğme metni gösterilmektedir.

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

Diğer metin kaynaklarını yerelleştirme

Komut adları dışındaki metin kaynakları kaynak (.resx) dosyalarında tanımlanır.

  1. VSPackage.resx'i VSPackage.en-US.resx olarak yeniden adlandırın.

  2. Her yerelleştirilmiş dil için VSPackage.en-US.resx dosyasının bir kopyasını yapın.

    Her kopyaya VSPackage adını verin.{ Locale}.resx, burada {Locale} belirli bir kültür adıdır.

  3. Resources.resx dosyasını Resources.en-US.resx olarak yeniden adlandırın.

  4. Her yerelleştirilmiş dil için Resources.en-US.resx dosyasının bir kopyasını yapın.

    Her kopyaya Kaynaklar adını verin.{ Locale}.resx, burada {Locale} belirli bir kültür adıdır.

  5. Dize değerlerini belirli bir dil ve kültüre uygun şekilde değiştirmek için her bir .resx dosyasını açın. Aşağıdaki örnekte, bir araç penceresinin başlık çubuğu için yerelleştirilmiş kaynak tanımı gösterilmektedir.

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

Yerelleştirilmiş kaynakları projeye ekleme

Yerelleştirilmiş kaynakları birleştirmek için assemblyinfo.cs dosyasını ve proje dosyasını değiştirmeniz gerekir.

  1. Çözüm Gezgini'deki Özellikler düğümünden düzenleyicide assemblyinfo.cs veya assemblyinfo.vb dosyasını açın.

  2. Aşağıdaki girdiyi ekleyin.

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

    Bu, ABD İngilizcesini varsayılan dil olarak ayarlar.

  3. Projeyi kaldırın.

  4. Proje dosyasını düzenleyicide açın.

  5. Kök Project öğesinde, varsayılan dilinizle eşleşen bir öğeye sahip bir UICulture öğe ekleyinPropertyGroup.

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

    Bu, ABD İngilizcesini Windows Presentation Foundation (WPF) denetimleri için varsayılan kullanıcı arabirimi kültürü olarak ayarlar.

  6. Öğeleri içeren EmbeddedResource öğeyi ItemGroup bulun.

  7. VSPackage.en-US.resx çağıran öğesinde ManifestResourceName öğesini olarak ayarlanmış VSPackage.en-US.Resourcesbir LogicalName öğeyle değiştirin:EmbeddedResource

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

  8. Her yerelleştirilmiş dil için VsPackage.en-USöğesini kopyalayın ve kopyanın EmbeddedResourceInclude özniteliğini ve LogicalName öğesini hedef yerel ayara ayarlayın.

  9. Her yerelleştirilmiş VSCTCompile öğeyeMenus.ctmenu, aşağıdaki örnekte gösterildiği gibi öğesine işaret eden bir ResourceName öğe ekleyin:

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

  10. Proje dosyasını kaydedin ve projeyi yeniden yükleyin.

  11. Projeyi derleyin.

    Bu, her dil için bir ana derleme ve kaynak derlemeleri oluşturur. Dağıtım işlemini yerelleştirme hakkında bilgi için bkz. VSIX paketlerini yerelleştirme

İlgili içerik