スプレッドシートのレンダリングのためのフォントの設定

可能な使用シナリオ

Aspose.Cells API は、スプレッドシートを画像形式でレンダリングしたり、PDF & XPS 形式に変換したりする機能を提供します。変換の精度を最大限にするためには、スプレッドシートで使用されているフォントがオペレーティングシステムのデフォルトのフォントディレクトリに存在する必要があります。必要なフォントが存在しない場合、Aspose.Cells API は代替のフォントを使用しようとします。

フォントの選択

Aspose.Cells API が裏で行うプロセスは以下の通りです。

API は、スプレッドシートで使用されている正確なフォント名と一致するフォントをファイルシステムで検索しようとします。
API が正確な同じ名前のフォントを見つけられない場合、ワークブックの DefaultStyle.Font プロパティで指定されたデフォルトフォントを使用しようとします。
API がワークブックの DefaultStyle.Font プロパティで定義されたフォントを見つけられない場合、PdfSaveOptions.DefaultFont または ImageOrPrintOptions.DefaultFont プロパティで指定されたフォントを使用しようとします。
API が PdfSaveOptions.DefaultFont または ImageOrPrintOptions.DefaultFont プロパティで定義されたフォントを見つけられない場合、FontConfigs.DefaultFontName プロパティで指定されたフォントを使用しようとします。
API が FontConfigs.DefaultFontName プロパティで定義されたフォントを見つけられない場合、利用可能なすべてのフォントから最適なフォントを選択しようとします。
最終的に API がファイルシステムでフォントを見つけられない場合、Arial を使用してスプレッドシートをレンダリングします。

Aspose.Cells API は常に操作システムのデフォルトのフォントディレクトリをスキャンします。ただし例外があります。それは、JVM 引数 -DAspose.Cells.FontDirExc=“YourFontDir” が設定されている場合で、その場合、Aspose.Cells API は操作システムのデフォルトのフォントディレクトリのスキャンをスキップし、上記の JVM 引数で指定されたパスのみを検索します。

カスタムフォントフォルダの設定

Aspose.Cells APIは必要なフォントを取得するために、オペレーティングシステムのデフォルトのフォントディレクトリを検索します。システムのフォントディレクトリに必要なフォントがない場合、APIはカスタム（ユーザー定義）ディレクトリを検索します。FontConfigsクラスでは、以下に詳細に述べられているように、カスタムフォントディレクトリを設定するためのいくつかの方法が公開されています。

1.FontConfigs.setFontFolder: このメソッドは1つのフォルダだけを設定する場合に有用です。 1.FontConfigs.setFontFolders: このメソッドは、フォントが複数のフォルダに存在し、ユーザーがすべてのフォルダを単一のフォルダにまとめるのではなく、それぞれ別々に設定したい場合に有用です。 1.FontConfigs.setFontSources: このメカニズムは、ユーザーが複数のフォルダからフォントを読み込む場合や、単一のフォントファイルやバイト配列からフォントデータを読み込みたい場合に有用です。

FontConfigs.setFontFolderおよびFontConfigs.setFontFoldersの両メソッドは、ブール型の2番目のパラメーターを受け入れます。2番目のパラメーターとしてtrueを渡すと、Aspose.Cells APIはフォントファイルのサブフォルダーを検索します。

上記のいずれかの方法をアプリケーションの開始時に使用してください。つまり、Aspose.Cells APIの他のオブジェクトを呼び出す前に使用してください。

上記の方法のいずれよりも複数の方法を使用してフォントソースを設定した場合、最後の設定のみが有効になります。

フォントの代替メカニズム

Aspose.Cells APIは、レンダリングのための代替フォントを指定する機能も提供します。このメカニズムは、必要なフォントが変換を行うマシンに存在しない場合に役立ちます。ユーザーはオリジナルの必要なフォントの代わりとしてフォント名のリストを指定できます。このために、Aspose.Cells APIはFontConfigs.setFontSubstitutesメソッドを公開しており、これは2つのパラメーターを受け入れます。1つ目のパラメーターはString型であり、代替する必要のあるフォントの名前でなければなりません。2つ目のパラメーターはString型の配列でなければなりません。ユーザーはオリジナルのフォントに代わる代替としてのフォント名のリストを提供することができます。

以下は単純な使用シナリオです。

 //Substituting the Arial font with Times New Roman & Calibri

FontConfigs.setFontSubstitutes("Arial", new String[] { "Times New Roman", "Calibri" });

情報収集

上記の方法に加えて、Aspose.Cells APIには設定されているソースと代替に関する情報を収集する手段も提供されています。

1.FontConfigs.getFontSources: このメソッドは、指定されたフォントソースのリストを含むFontSourceBase型の配列を返します。ソースが設定されていない場合、FontConfigs.getFontSourcesメソッドは空の配列を返します。 1.FontConfigs.getFontSubstitutes: このメソッドはString型のパラメーターを受け入れます。これを使用して設定したフォント名を指定することができます。指定されたフォント名に対する代替が設定されていない場合、FontConfigs.getFontSubstitutesメソッドはnullを返します。

サポートされているフォント形式ワークブックのレンダリング用に個々またはプライベートなフォントセットを指定する