Comment : localiser des solutions Excel

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Excel 2003 Excel 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Excel 2003
Excel 2007

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

La localisation consiste principalement à traduire l'interface utilisateur de votre application. Au lieu de coder des chaînes en dur dans votre application, vous devez stocker les chaînes dans un fichier séparé. Vous pouvez stocker des chaînes pour les éléments de l'interface utilisateur Microsoft Office Excel dans le fichier de ressources de l'assembly par défaut du projet. Le fichier est nommé MyResources.resx dans les projets Visual Basic et Resources.resx dans les projets C#. Les copies du fichier de ressources peuvent ensuite être traduites dans plusieurs langues.

Remarque :
Votre ordinateur risque d'afficher des noms ou des emplacements différents pour certains éléments de l'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Stockage de texte dans un fichier de ressources

Pour ajouter du texte à un fichier de ressources

Ouvrez le projet Excel que vous souhaitez localiser.
Dans le menu Projet, sélectionnez Propriétés de <NomProjet>.

Le Concepteur de projets s'ouvre.
Cliquez sur Ressources dans Concepteur de projets pour ouvrir le volet Ressources.
Sélectionnez Chaînes dans la zone de liste déroulante Catégories.
Ajoutez un identificateur unique à la colonne Nom et au texte à localiser dans la colonne Valeur pour chaque chaîne que vous souhaitez localiser. Par exemple :

Nom

Valeur

ListCreateUnscheduledOrder

créer un ordre non planifié

Remarque :

Vous pouvez utiliser la colonne Commentaire pour fournir des remarques ou des instructions au traducteur.

Nom	Valeur
ListCreateUnscheduledOrder	créer un ordre non planifié

Remarque :
Vous pouvez utiliser la colonne Commentaire pour fournir des remarques ou des instructions au traducteur.

Récupération de texte à partir d'un fichier de ressources

Une fois que vous avez ajouté chaque chaîne au fichier de ressources, les chaînes peuvent être chargées au moment de l'exécution.

Pour ajouter une valeur à une cellule à l'aide d'un fichier de ressources.

Dans le gestionnaire d'événements Startup de Sheet1, ajoutez un contrôle NamedRange à la cellule 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");

Assignez une valeur du fichier de ressources.

namedRange1.Value2 = My.Resources.ListCreateUnscheduledOrder

namedRange1.Value2 = Properties.Resources.ListCreateUnscheduledOrder;

Localisation du fichier de ressources

Pour localiser un fichier de ressources

Copiez le fichier de ressources et nommez-le avec le code de culture de la langue cible. Par exemple, pour créer un fichier qui sera localisé en japonais, copiez le fichier Resources.resx et nommez-le Resources.ja.resx.
Faites traduire le fichier de ressources dans les langues que vous souhaitez prendre en charge. Par exemple, faites traduire les chaînes du fichier Resources.ja.resx en japonais.
Ajoutez les fichiers de ressources traduits à votre projet afin que le système de projet puisse compiler les fichiers de ressources dans des assemblys satellites.

Chargement des ressources basées sur la langue de l'interface utilisateur Office

Microsoft .NET Framework charge des ressources basées sur la langue de l'interface utilisateur Microsoft Windows. Toutefois, les solutions Office sont généralement écrites pour charger des ressources basées sur la langue de l'interface utilisateur Office. Le premier exemple ci-dessous montre comment charger des ressources qui correspondent à la langue de l'interface utilisateur Office, quelle que soit la version d'Office installée. Le deuxième exemple montre comment substituer à la fois la langue de l'interface utilisateur Office et le comportement de Microsoft .NET Framework par défaut.

Pour charger des ressources basées sur Office (plusieurs versions linguistiques d'Office)

Ajoutez le code suivant au gestionnaire d'événements Startup pour le classeur et chacune des feuilles de calcul.

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));

Si vous n'avez pas plusieurs versions linguistiques d'Office, vous pouvez forcer le chargement des ressources en assignant l'ID de culture correspondant à la propriété CurrentCulture de l'objet CultureInfo (ou celui du thread en cours). Cela peut être utile pour effectuer des opérations de débogage ou dans le cadre du code personnalisé qui permet aux utilisateurs de sélectionner les ressources à charger.

Pour charger des ressources basées sur Office (à l'aide de l'ID de culture)

Ajoutez le code suivant au gestionnaire d'événements Startup pour le classeur et chacune des feuilles de calcul. Cet exemple passe l'ID de culture pour l'allemand (Allemagne). Pour obtenir la liste des ID de culture, consultez CultureInfo.
```
System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo("de")
```
```
System.Threading.Thread.CurrentThread.CurrentUICulture = 
    new System.Globalization.CultureInfo("de");
```

Localisation de contrôles personnalisés

Vous pouvez ajouter des contrôles personnalisés au volet Actions dans les solutions Visual Studio Tools pour Office. Vous pouvez activer la localisation d'un contrôle utilisateur ou d'un contrôle de volet Actions de la même façon que vous localiseriez un formulaire Windows. Pour plus d'informations, consultez Procédure pas à pas : localisation de Windows Forms.

Pour activer la localisation d'un contrôle personnalisé

Dans le menu Affichage, sélectionnez Fenêtre Propriétés.
Sélectionnez le contrôle utilisateur ou le contrôle de volet Actions dans le concepteur et remplacez la valeur de la propriété Localizable par true.

Voir aussi

Partager via