Freigeben über


Gewusst wie: Suchen Sie Menübefehle

Sie können lokalisierten Text für Menü- und Symbolleisten Befehle zum Erstellen von isolierten .vsct-Dateien und einen lokalisierten RESX-Dateien für ein VSPackage, und die Projektdateien dann aktualisieren bereitstellen, um die Änderungen zu speichern.

Weitere Informationen dazu, wie Sie die Installation, finden Sie unter Lokalisieren von VSIX-Paketenisoliert.

Suchen Befehls-Namen

In VSPackages sind Menübefehle und Symbolleisten-Schaltflächen in der .vsct-Datei definiert.

So erstellen Sie Menübefehle lokalisierte

  1. In Projektmappen-Explorerändern Sie den Namen der .vsct-Datei von Dateiname.vsct zu Dateiname.en-US.vsct.

  2. Erstellen einer Kopie von Dateiname.en-US.vsct für jede lokalisierte Sprache.

    Geben Sie für jede Kopie Dateiname.Gebietsschema.vsct, wo Gebietsschema ein bestimmter Kulturname ist. Eine Liste der Kulturname werten finden Sie unter National Language Support (NLS) API Reference auf der MSDN-Website.

    Dieses Dateiname.GebietsschemaDateien enthalten den lokalisierten .vsct Menütext für das Paket.

  3. Öffnen Sie ein Dateiname.GebietsschemaDatei .vsct, um Text zu suchen.

    1. Ändern Sie die ButtonText-Elementwerte Bedarf für die jeweilige Sprache.

    2. Wenn Sie lokalisierte Symbolen bereitstellen, ändern Sie die Bitmap-Werte, die an die Zieldateien zu veranschaulichen.

    Im folgenden Beispiel wird die englische und spanischen Schaltflächentext an, damit ein Befehl ein Tool Stammbaum-Explorer Fenster geöffnet.

    [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 Arboles de Familias</ButtonText>
      </Strings>
    </Button>
    

Andere Text-Betriebsmittel suchen

Ressourcen von Text anders Befehlsnamen werden in Ressourcendateien (RESX-Dateien) definiert.

So erstellen Sie die lokalisierten Ressourcendateien

  1. Benennen Sie VSPackage.resx zu VSPackage.en-US.resx.

  2. Erstellen Sie eine Kopie der VSPackage.en-US.resx Datei für jede lokalisierte Sprache.

    Geben Sie für jede Kopie VSPackage.Gebietsschema.resx, wo Gebietsschema ein bestimmter Kulturname ist.

  3. Umbenennen von Resources.resx auf Resources.en-US.resx.

  4. Erstellen Sie eine Kopie davon Resources.en-US.resx Datei für jede lokalisierte Sprache.

    Geben Sie für jede Kopie Ressourcen frei.Gebietsschema.resx, wo Gebietsschema ein bestimmter Kulturname ist.

  5. Öffnen Sie eine RESX-Datei, um die Zeichenfolgenwerte für die jeweilige Sprache und Kultur bei Bedarf zu ändern. Im folgenden Beispiel wird die lokalisierte Ressourcendefinition für die Titelleiste eines Toolfensters an.

    [Resources.en-US.resx]

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

    [Resources.es-ES.resx]

    <data name="ToolWindowTitle" xml:space="preserve">
      <value>Explorador de los Arboles de Familia</value>
    </data>
    
    <data name="ToolWindowTitle" xml:space="preserve">
      <value>Explorador de los Arboles de Familia</value>
    </data>
    

Lokalisierte Ressourcen in das Projekt integrieren

Sie müssen die assemblyinfo.cs-Datei und die Projektdatei ändern, um die lokalisierten Ressourcen enthalten soll.

Um die lokalisierten Ressourcen in das Projekt integrieren

  1. Klicken Eigenschaften Knoten in Projektmappen-Explorer, öffnen Sie assemblyinfo.cs oder assemblyinfo.vb im Editor.

  2. Fügen Sie folgenden Eintrag hinzu.

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

    Dadurch wird US-Englisch als Standardsprache festgelegt.

  3. Nehmen Sie das Projekt entladen.

  4. Öffnen Sie die Projektdatei im Editor.

  5. Suchen Sie das ItemGroup-Element, das EmbeddedResource-Elemente enthält.

  6. Im EmbeddedResource-Element, das VSPackage.en-US.resx aufruft, ersetzen Sie das ManifestResourceName-Element durch ein LogicalName Menge VSPackage.en-US.ResourcesElement wie folgt.

    <EmbeddedResource Include="VSPackage.en-US.resx">
      <MergeWithCTO>true</MergeWithCTO>
      <LogicalName>VSPackage.en-US.Resources</LogicalName>
    </EmbeddedResource>
    
  7. Für jede lokalisierte Sprache kopieren Sie das EmbeddedResource-Element für VsPackage.en-US, und legen Sie das Include-Attribut und das LogicalName-Element der Kopie Gebietsschema an, wie im folgenden Beispiel gezeigt.

  8. So fügen Sie einem lokalisierten VSCTCompile fügen Sie ein Element ResourceName-Element, das Menus.ctmenuzeigt, wie im folgenden Beispiel gezeigt.

    <ItemGroup>
      <VSCTCompile Include="LocalizedPackage.es-ES.vsct">
        <ResourceName>Menus.ctmenu</ResourceName>
      </VSCTCompile>
    </ItemGroup>
    
  9. Speichern Sie die Projektdatei erneut, und laden Sie das Projekt.

  10. Erstellen Sie das Projekt.

    Dadurch wird eine Hauptassembly und Ressourcenassemblys für jede Sprache. Weitere Informationen über das Lokalisieren des Bereitstellungsprozesses finden Sie unter Lokalisieren von VSIX-Paketen

Siehe auch

Aufgaben

Gewusst wie: Erstellen und behandeln Sie Befehle in VSPackages (C#)

Weitere Ressourcen

Allgemeine Aufgaben mit Befehlen, Menüs und Symbolleisten

Globalisieren und Lokalisieren von .NET Framework-Anwendungen