Procedura: localizzare i comandi di menu

Articolo
05/17/2015

È possibile fornire testo localizzato per i controlli barra degli strumenti e del menu creazione di file localizzati di .vsct e i file resx localizzati per il package VS e di aggiornare i file di progetto per includere le modifiche.

Per informazioni su come localizzare l'installazione, vedere Localizzazione di pacchetti VSIX.

Localizzare i nomi dei comandi

In VSPackages, i comandi di menu e pulsanti della barra degli strumenti sono definiti nel file di .vsct.

In Esplora soluzioni, modificare il nome del file di .vsct da nome file.vsct a nome file.en-US.vsct.
Fare una copia di nome file.en-US.vsct per ogni lingua localizzata.

Assegnare a ogni copia nome file.impostazioni locali.vsct, dove impostazioni locali è un nome di impostazioni cultura specifico. Per un elenco di valori ai nomi delle impostazioni cultura, vedere Riferimento API national (NLS) institute del supporto linguistico il sito Web MSDN.

questo nome file. i file diimpostazioni locali.vsct conterranno il testo localizzato del menu per il pacchetto.

aprire ogni nome file. file diimpostazioni locali.vsct per localizzare il testo.

Modificare i valori degli elementi di ButtonText a seconda del linguaggio specifico.
Se si fornirà le icone localizzate, modificare i valori di bitmap per indicare i file di destinazione.

Nell'esempio seguente viene illustrato il testo del pulsante inglese e spagnolo per un comando apra una finestra degli strumenti di Esplora Risorse con struttura ad albero genealogico.

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

Localizzare altre risorse del testo

Le risorse di testo diversi dai nomi dei comandi vengono definite in file di risorse (resx).

Per creare file di risorse localizzati

rinominare VSPackage.resx a VSPackage.en-US.resx.
Fare una copia del file di VSPackage.en-US.resx per ogni lingua localizzata.

Assegnare a ogni copia VSPackage.impostazioni localiresx, dove impostazioni locali è un nome di impostazioni cultura specifico.
rinominare Resources.resx a Resources.en-US.resx.
Fare una copia del file di Resources.en-US.resx per ogni lingua localizzata.

Denominazione delle risorse di ogni copia.impostazioni localiresx, dove impostazioni locali è un nome di impostazioni cultura specifico.

Aprire ogni file RESX per modificare i valori stringa in base alle proprie esigenze specifiche per la lingua e le impostazioni cultura specifiche. Nell'esempio seguente viene illustrata la definizione localizzata di risorse per la barra del titolo di una finestra degli strumenti.

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

Incorporare le risorse localizzate nel progetto

È necessario modificare il file assemblyinfo.cs e il file di progetto per includere risorse localizzate.

Per includere risorse localizzate nel progetto

Dal nodo di Proprietà in Esplora soluzioni, aprire assemblyinfo.cs o assemblyinfo.vb nell'editor.

Aggiungere la voce seguente.

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

Questo imposta inglese Stati Uniti come lingua predefinita.

scaricare il progetto.
Aprire il file di progetto nell'editor.
Individuare l'elemento di ItemGroup contenente gli elementi di EmbeddedResource .
Nell'elemento di EmbeddedResource che chiama VSPackage.en-US.resx, sostituire l'elemento con un elemento di LogicalName , set di ManifestResourceName a VSPackage.en-US.Resources, come illustrato di seguito.
```
<EmbeddedResource Include="VSPackage.en-US.resx">
  <MergeWithCTO>true</MergeWithCTO>
  <LogicalName>VSPackage.en-US.Resources</LogicalName>
</EmbeddedResource>
```
Per ogni lingua localizzata, copiare l'elemento di EmbeddedResource per VsPackage.en-US e impostare l'attributo di Importare e l'elemento di LogicalName della copia delle impostazioni locali di destinazione, come illustrato nell'esempio seguente.
A ogni elemento localizzato di VSCTCompile , aggiungere un elemento di ResourceName che indica Menus.ctmenu, come illustrato nell'esempio seguente.
```
<ItemGroup>
  <VSCTCompile Include="LocalizedPackage.es-ES.vsct">
    <ResourceName>Menus.ctmenu</ResourceName>
  </VSCTCompile>
</ItemGroup>
```
salvare il file di progetto e ricaricare il progetto.
Compilare il progetto.

Verrà creato un assembly principale e gli assembly di risorse per ogni linguaggio. Per informazioni sulla localizzazione il processo di distribuzione, vedere Localizzazione di pacchetti VSIX

Vedere anche

Attività

Procedura: Creare e gestire i comandi in Vspackage (c#)

Altre risorse

Attività comuni con i controlli, i menu e le barre degli strumenti

Globalizzazione e localizzazione di applicazioni .NET Framework

Condividi tramite