VintaSoft Imaging .NET SDK を任意の言語にローカライズ

VintaSoft Imaging .NET SDK は、任意の言語にローカライズできます。

SDK には、ローカライズされた VintaSoft .NET アセンブリと、ドイツ語にローカライズされた VintaSoft WinForms デモ プロジェクトが含まれており、例として、SDK を任意の言語にローカライズできます。

また、SDK には、ローカライズされた VintaSoft ASP.NET Core デモ プロジェクトが含まれており、例として、Web 用の SDK ソリューションを任意の言語にローカライズできます。

VintaSoft .NET アセンブリの文字列定数と UI コントロールをローカライズする場合は、この記事の「VintaSoft .NET アセンブリのローカライズ」セクションでその方法をお読みください。

VintaSoft WinForms デモ プロジェクトの文字列定数と UI をローカライズする場合は、この記事の「VintaSoft WinForms デモ プロジェクトのローカライズ」セクションでその方法をお読みください。

VintaSoft ASP.NET デモ プロジェクトの文字列定数と UI をローカライズする場合は、この記事の「VintaSoft ASP.NET デモ プロジェクトのローカライズ」セクションでその方法をお読みください。

VintaSoft .NET アセンブリのローカライズ

すべての VintaSoft .NET アセンブリは英語にローカライズされています。

また、VintaSoft Imaging .NET SDK は、次の VintaSoft .NET アセンブリ (サテライト リソース アセンブリを使用) を任意の言語にローカライズする機能を提供します:

• Vintasoft.Imaging.dll
• Vintasoft.Imaging.UI.dll
• Vintasoft.Imaging.Annotation.Dicom.dll
• Vintasoft.Imaging.Annotation.Dicom.UI.dll
• Vintasoft.Imaging.Annotation.Dicom.Wpf.UI.dll
• Vintasoft.Imaging.Dicom.dll
• Vintasoft.Imaging.Dicom.Mpr.dll
• Vintasoft.Imaging.Dicom.Mpr.UI.dll
• Vintasoft.Imaging.Dicom.Mpr.Wpf.UI.dll
• Vintasoft.Imaging.Dicom.UI.dll
• Vintasoft.Imaging.Dicom.Wpf.UI.dll
• Vintasoft.Imaging.Pdf.dll
• Vintasoft.Imaging.Pdf.JavaScript.dll
• Vintasoft.Imaging.Pdf.UI.dll
• Vintasoft.Imaging.Pdf.Wpf.UI.dll

上記のリストにない Vintasoft .NET アセンブリをローカライズする場合は、お知らせください。必要な Vintasoft .NET アセンブリをローカライズする機能を提供します。

VintaSoft Imaging .NET SDK のインストーラーは、ドイツ語のサテライト アセンブリを提供します。これは、"{SdkInstallPath}\Imaging .NET v12.2\Bin\DotNetX\AnyCPU\de\" フォルダーにあります。

上記のリストにある VintaSoft .NET アセンブリ (たとえば Vintasoft.Imaging.Pdf.dll) をローカライズする場合は、次の手順を実行する必要があります:

• Vintasoft.Imaging.Pdf.dll アセンブリから定数文字列を含む "Vintasoft.Imaging.Pdf.Localization.Strings.resources" リソース ファイルを抽出します。
  以下は、Vintasoft.Imaging.Pdf.dll アセンブリから「Vintasoft.Imaging.Pdf.Localization.Strings.resources」リソースファイルを抽出するための .NET コンソールアプリケーションの C# コードです。
  

  namespace ConsoleApp1
  {
      internal class Program
      {
          static void Main(string[] args)
          {
              string dotNetAssemblyFileName = @"D:\VintaSoft\Imaging .NET v12.2\Bin\DotNet7\AnyCPU\Vintasoft.Imaging.Pdf.dll";
              string resourceFileName = "Vintasoft.Imaging.Pdf.Localization.Strings.resources";
              ExtractBinaryResourceFromDotNetAssembly(dotNetAssemblyFileName, resourceFileName);
          }
  
          static void ExtractBinaryResourceFromDotNetAssembly(string dotNetAssemblyFileName, string resourceFileName)
          {
              System.Reflection.Assembly assembly = System.Reflection.Assembly.LoadFile(dotNetAssemblyFileName);
  
              System.IO.Stream resourceStream = assembly.GetManifestResourceStream(resourceFileName);
  
              byte[] resourceStreamBytes = new byte[resourceStream.Length];
              resourceStream.Read(resourceStreamBytes, 0, resourceStreamBytes.Length);
  
              System.IO.File.WriteAllBytes(resourceFileName, resourceStreamBytes);
          }
  
      }
  }
  
  

• 抽出した「Vintasoft.Imaging.Pdf.Localization.Strings.resources」リソースファイルを .resx ファイルに変換します。これは、ResGen ユーティリティを使用して実行できます。
  以下は、.NET バイナリリソースファイルを .resx ファイルに変換するためのコマンドラインです。
  

  "{Path_to_ResGen.exe_file}\ResGen.exe"  Vintasoft.Imaging.Pdf.Localization.Strings.resources  Strings.resx
  

• 必要な言語 (スペイン語など) に翻訳された定数文字列を含む Strings.resx ファイルを作成します。
  • String.resx ファイルの名前を Strings.es.resx ファイルに変更します。
  • 任意のテキスト エディターで Strings.es.resx ファイルを開き、文字列定数 (「value」タグ内の文字列) を英語からスペイン語に翻訳します。
• 翻訳された定数文字列を含むサテライト アセンブリを作成します。
  • 「Vintasoft.Imaging.Pdf.es.resources」フォルダーを作成し、そのフォルダーに移動します。
  • 任意のテキスト エディターを使用して「Vintasoft.Imaging.Pdf.csproj」ファイルを作成し、作成したファイルに次のテキストを追加します。
    

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFramework>net7.0</TargetFramework>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
      </PropertyGroup>
    </Project>
    

  • 「Localization」フォルダーを作成し、そのフォルダーに移動します。
  • Strings.es.resx ファイルを「Localization」フォルダーにコピーします。
  • 「Vintasoft.Imaging.Pdf.es.resources」フォルダーに移動します。
  • 以下のコマンドを使用してプロジェクトをコンパイルします:
    

    dotnet build Vintasoft.Imaging.Pdf.csproj
    

  • サテライト アセンブリ「Vintasoft.Imaging.Pdf.resources.dll」が「bin\Debug\net7.0\es\」フォルダに作成されます。
• サテライト アセンブリを Vintasoft.Imaging.Pdf.dll アセンブリと共に使用します:
  • Vintasoft.Imaging.Pdf.dll アセンブリがあるフォルダに「es」フォルダを作成します。
  • 作成したサテライト アセンブリ「Vintasoft.Imaging.Pdf.resources.dll」を「es」フォルダにコピーします。
  • Vintasoft.Imaging.Pdf.dll アセンブリを使用するアプリケーションを実行すると、コンピュータがスペイン語ロケールを使用している場合はスペイン語のテキストが表示されます。
  • スペイン語以外のロケールを使用しているコンピュータでスペイン語のテキストを表示する場合は、.NET アプリケーションのロケールをスペイン語ロケールに設定することもできます。
    .NET アプリケーションにスペイン語のロケールを設定する方法を示す C# コードは次のとおりです。
    

    System.Globalization.CultureInfo.CurrentCulture = new System.Globalization.CultureInfo("es");
    System.Globalization.CultureInfo.CurrentUICulture = new System.Globalization.CultureInfo("es");
    

VintaSoft WinForms デモ プロジェクトをローカライズします。

WinForms プロジェクトをローカライズする場合は、次の手順を実行する必要があります。

• プロジェクトで使用される WinForms フォームの UI をローカライズします。
  • プロジェクトの各 WinForms フォームについて:
    • Visual Studio の WinForms デザイナーで WinForms フォームを開きます。
    • フォームの "Localizable" プロパティを True に設定します。
    • フォームの「言語」プロパティを希望の言語（たとえばスペイン語）に設定すると、デザイナーはフォームのスペイン語ローカライズに関する情報を含む FormName.es.resx ファイルを作成します。
    • フォームの UI 要素をローカライズすると、ローカライズに関する情報が FormName.es に保存されます。resx ファイル。
• プロジェクトのソース コードで使用される文字列定数をローカライズします。
  • プロジェクトに「Localization」フォルダーを作成します。
  • 「Strings.resx」という名前のリソース ファイルを「Localization」フォルダーに追加します。
  • プロジェクト コード内の各定数文字列について:
    • 定数文字列を Strings.resx リソース ファイルに追加します。
    • プロジェクト コード内の定数文字列を、Strings.resx リソース ファイル内の定数文字列にアクセスするコードに置き換えます。

すべての VintaSoft WinForms デモ プロジェクトは英語にローカライズされています。
SDK では、3 つの VintaSoft WinForms デモ プロジェクト (DicomViewerDemo、PdfEditorDemo、SpreadsheetEditorDemo) のドイツ語ローカライズも提供しており、これは VintaSoft WinForms デモ プロジェクトが任意の言語にローカライズできることを示しています。

既にローカライズされている (ドイツ語にローカライズされているなど) VintaSoft WinForms デモ プロジェクトをローカライズする場合は、次の手順を実行する必要があります。

• プロジェクトで使用される WinForms フォームの UI を、上記の任意の WinForms プロジェクトのローカライズ手順で説明されている方法でローカライズします。
• プロジェクトのソース コードで使用される文字列定数をローカライズします。
  • 「Localization\Strings.resx」ファイルのコピーを作成します => 「Strings - Copy.resx」および「Strings - Copy.Designer.cs」ファイルが作成されます。
  • ファイル「Strings - Copy.Designer.cs」を削除します。
  • ファイル「Strings - Copy.resx」の名前を「Strings.es.resx」ファイルに変更します。
  • Visual Studio のリソース デザイナーで「Strings.es.resx」ファイルを開き、文字列定数を英語からスペイン語に翻訳します。

現在ローカライズされていない VintaSoft WinForms デモ プロジェクトをローカライズする場合は、2 つの方法があります。
方法 1: 上記の WinForms プロジェクトのローカライズ手順で VintaSoft WinForms デモ プロジェクトをローカライズします。
方法 2: VintaSoft WinForms デモ プロジェクトを希望の言語にローカライズするリクエストをお送りください。ローカライズのお手伝いをさせていただきます。

VintaSoft ASP.NET デモ プロジェクトをローカライズします

各 VintaSoft ASP.NET デモ プロジェクトは、Web アプリケーションの UI とロジックを定義する JavaScript UI コントロールと、JavaScript UI コントロールからの要求に対応し、VintaSoft Imaging .NET SDK の機能を使用する VintaSoft Web サービスの 2 つの部分から構成されます。

VintaSoft ASP.NET Core ドキュメント ビューアー デモには、すぐに使用できるローカリゼーション辞書が用意されており、VintaSoft Web ドキュメント ビューアーを 32 の言語 (アフリカーンス語、アラビア語、ベラルーシ語、ブルガリア語、中国語、クロアチア語、チェコ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ヒンディー語、ハンガリー語、イタリア語、日本語、韓国語、ノルウェー語、ポルトガル語、ルーマニア語、ロシア語、スロバキア語、スロベニア語、スペイン語、スワヒリ語、スウェーデン語、トルコ語、ベトナム語、ズールー語) にローカライズできます。 VintaSoft Web Document Viewerのすぐに使えるローカリゼーションは、VintaSoft ASP.NET Core Document Viewer Demoのオンライン版を使用してテストできます。VintaSoft Web Document Viewerのローカリゼーションの詳細については、こちらをご覧ください。

VintaSoft ASP.NET スプレッドシート エディター デモには、すぐに使用できるローカリゼーション辞書が用意されており、VintaSoft Web スプレッドシート ドキュメント エディターを 32 の言語 (アフリカーンス語、アラビア語、ベラルーシ語、ブルガリア語、中国語、クロアチア語、チェコ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ヒンディー語、ハンガリー語、イタリア語、日本語、韓国語、ノルウェー語、ポルトガル語、ルーマニア語、ロシア語、スロバキア語、スロベニア語、スペイン語、スワヒリ語、スウェーデン語、トルコ語、ベトナム語、ズールー語) にローカライズできます。 VintaSoft Web Document Viewerのすぐに使えるローカリゼーションは、VintaSoft ASP.NET Core Spreadsheet Editor Demoのオンライン版を使用してテストできます。VintaSoft Web Spreadsheet Document Editorのローカリゼーションの詳細については、こちらをご覧ください。

VintaSoft ASP.NET Core ドキュメント ビューアー デモおよび VintaSoft ASP.NET スプレッドシート エディター デモのすぐに使用できるローカライズ辞書は、どの ASP.NET デモ プロジェクトでも使用できます。つまり、ローカライズ辞書は、ASP.NET Core、ASP.NET Core + Angular、ASP.NET MVC5、および ASP.NET WebForms で使用できます。これは、VintaSoft ASP.NET デモがすべての ASP.NET プラットフォームに対して同じ JavaScript コードを使用するため可能です。

VintaSoft Web サービスによって返される文字列定数をローカライズする場合は、「VintaSoft のローカライズ」の説明に従って VintaSoft .NET アセンブリをローカライズする必要があります。