Como: Localize soluções do Excel

Artigo
08/08/2011

Localização consiste basicamente da tradução da interface do usuário do seu aplicativo. Em vez de um disco rígidas seqüências de codificação em seu aplicativo, você deve armazenar as seqüências de caracteres em um arquivo separado. Você pode armazenar seqüências de caracteres para elementos de interface de usuário do Excel de Microsoft Office no arquivo de recurso de assembly do projeto padrão. O arquivo é denominado MyResources.resx em projetos de Visual Basic e Resources. resx em projetos de C#. Cópias do arquivo de recurso, em seguida, podem ser traduzidas em vários idiomas.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

Armazenar o texto em um arquivo de recurso

Para adicionar texto a um arquivo de recurso

Abra o projeto do Excel que você deseja localizar.
Sobre o projeto menu, selecione <Projectname> Propriedades.

The Project Designer opens.
Clique em recursos na Project Designer para abrir o recursos painel.
Selecione seqüências na categorias caixa de combinação.
Adicionar um identificador exclusivo para o nome coluna e o texto a ser localizado na valor coluna para cada seqüência de caracteres que você deseja localizar. For example:

Name

Value

ListCreateUnscheduledOrder

Criar ordem de não-programado

Observação

Você pode usar o comentário coluna para fornecer observações ou instruções para o conversor.

Name	Value
ListCreateUnscheduledOrder	Criar ordem de não-programado

Observação
Você pode usar o comentário coluna para fornecer observações ou instruções para o conversor.

Recuperar texto de um arquivo de recurso

Depois de ter adicionado a cada seqüência de caracteres para o arquivo de recurso, as seqüências de caracteres podem ser carregadas em tempo de execução.

Para adicionar um valor a uma célula, usando um arquivo de recurso.

No Startup manipulador de eventos de Sheet1, adicionar um NamedRange o controle para a célula A1.

Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange = _
    Me.Controls.AddNamedRange(Me.Range("A1"), "NamedRange1")

Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
    this.Controls.AddNamedRange(this.Range["A1", missing], "namedRange1");

Atribua um valor a partir do arquivo de recurso.

namedRange1.Value2 = My.Resources.ListCreateUnscheduledOrder

namedRange1.Value2 = Properties.Resources.ListCreateUnscheduledOrder;

Localizando o arquivo de recurso

Para localizar um arquivo de recurso

Copie o arquivo de recurso e nomeie-o com o código de cultura do idioma de destino. Por exemplo, para criar um arquivo que será localizado em japonês, copie o arquivo Resources. resx e denomine-o Resources.ja.resx.
Ter o arquivo de recurso traduzido para os idiomas que você deseja oferecer suporte. Por exemplo, ter as seqüências de caracteres Resources.ja.resx traduzido em japonês.
Adicione os arquivos de recursos traduzidos para o seu projeto para que o sistema de projeto pode compilar os arquivos de recursos em assemblies satélites.

Carregando recursos com base no idioma de Interface de usuário do Office

A Microsoft.NET Framework carrega os recursos com base no idioma da interface de usuário do Microsoft Windows. Soluções baseadas no Office, no entanto, normalmente são gravadas para carregar os recursos com base no idioma de interface (UI) de usuário do Office. O primeiro exemplo a seguir demonstra como carregar os recursos que corresponda ao idioma da interface do usuário do Office, independentemente de qual versão do Office está instalado. O segundo exemplo mostra como substituir o idioma da interface do usuário do Office e o padrão do Microsoft.Comportamento do NET Framework.

Para carregar os recursos com base no Office (várias versões de idioma do Office)

Adicione o seguinte código para o Startup o manipulador de eventos para a pasta de trabalho e cada uma das planilhas.

System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo( _
        Application.LanguageSettings.LanguageID( _
            Office.MsoAppLanguageID.msoLanguageIDUI))

System.Threading.Thread.CurrentThread.CurrentUICulture =
    new System.Globalization.CultureInfo(
        Application.LanguageSettings.get_LanguageID(
            Office.MsoAppLanguageID.msoLanguageIDUI));

Se você tiver várias versões de idioma do Office, você pode forçar os recursos para carregar, atribuindo a identificação da cultura correspondente para o CurrentCulture propriedade da CultureInfo objeto (ou do segmento atual). Isso pode ser útil para fins de depuração ou como parte do código personalizado que permite aos usuários selecionar quais recursos para carregar.

Para carregar os recursos com base no Office (usando a identificação de cultura)

Adicione o seguinte código para o Startup o manipulador de eventos para a pasta de trabalho e cada uma das planilhas. Este exemplo passa a identificação de cultura para alemão (Alemanha). Para obter uma lista de IDs de cultura, consulte CultureInfo.
```
System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo("de")
```
```
System.Threading.Thread.CurrentThread.CurrentUICulture = 
    new System.Globalization.CultureInfo("de");
```

A localização de controles personalizados

Você pode adicionar controles personalizados para o painel de ações em soluções do Office. Você pode ativar a localização de um controle de usuário ou um controle do painel de ações da mesma maneira que você deseja localizar um formulário do Windows. For more information see, Demonstra Passo a passo: Localizando Windows Forms.

Para permitir a localização de um controle personalizado

Do Exibir menu, selecione A janela de propriedades.
Selecione o controle de usuário ou o controle do painel Ações no designer e alterar o Localizable propriedade para true.

Consulte também

Compartilhar via