Auf Sprachen zugreifen - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Auf Sprachen zugreifen

Voraussetzung

Einleitung

Im TIA Portal können Sie die Projektsprache im Editor "Projektsprachen" festlegen und verwalten.

TIA Portal Openness unterstützt den folgenden Zugriff auf die Projektsprachen:

  • Iteration durch unterstützte Sprachen.

  • Suchen in der Sammlung unterstützter Sprachen mithilfe von System.Globalization.CultureInfo.

  • Zugriff auf einzelne Sprachen. Jedes Sprachobjekt enthält ein einziges schreibgeschütztes Attribut Culture vom Typ System.Globalization.CultureInfo..

  • Zugriff auf eine Sammlung aktiver Sprachen.

  • Suchen in der Sammlung aktiver Sprachen über mit Hilfe von System.Globalization.CultureInfo.

  • Hinzufügen einer Sprache zu einer Sammlung aktiver Sprachen.

  • Entfernen einer Sprache aus einer Sammlung aktiver Sprachen.

  • Festlegen einer Bearbeitungssprache.

  • Festlegen einer Referenzsprache.

Die Funktionalitäten werden vom Objekt LanguageSettings bereitgestellt. Die folgende Abbildung zeigt das Modell in TIA Portal Openness:

Programmcode: Sprachen festlegen

Ändern Sie den folgenden Programmcode, um eine Sprache festzulegen. Wenn Sie über TIA Portal Openness eine inaktive Sprache festlegen, wird die Sprache der Sammlung aktiver Sprachen hinzugefügt.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void SettingLanguages()

{

   TiaPortal tiaPortal = new TiaPortal();

   Project project = tiaPortal.Projects.

   Open(new FileInfo(@"D:\Project_3\Project_2.apXX"));

   LanguageSettings languageSettings = project.LanguageSettings;

   LanguageComposition supportedLanguages = languageSettings.Languages;

   LanguageAssociation activeLanguages = languageSettings.ActiveLanguages;

   Language supportedGermanLanguage = supportedLanguages.

   Find(CultureInfo.GetCultureInfo("de-DE"));

   activeLanguages.Add(supportedGermanLanguage);

   languageSettings.EditingLanguage = supportedGermanLanguage;

   languageSettings.ReferenceLanguage = supportedGermanLanguage;

}

Programmcode: Eine aktive Sprache deaktivieren

Um eine aktive Sprache zu deaktivieren, ändern Sie den folgenden Programmcode. Wenn Sie eine Sprache deaktivieren, die als Referenz- oder Bearbeitungssprache verwendet wird, ist die ausgewählte Sprache konsistent mit dem Verhalten in der Benutzeroberfläche.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static LanguageSettings DeactivatingLanguages(TiaPortal tiaPortal, string projectPath)

{

   try

   {

   Project project = tiaPortal.Projects.Open(new FileInfo(projectPath));

   LanguageSettings languageSettings = project.LanguageSettings;

   LanguageAssociation activeLanguages = languageSettings.ActiveLanguages;

   Language activeGermanLanguage = activeLanguages.

   Find(CultureInfo.GetCultureInfo("de-DE"));

   activeLanguages.Remove(activeGermanLanguage);

   return languageSettings;

   }

   catch(Exception ex)

   {

   Console.WriteLine($"Exception of type {ex.GetType()} occurred: {ex.Message}");

   return null;

   }

}