LanguageFontGroup クラス

  • リファレンス

定義

名前空間:
Windows.Globalization.Fonts
編集

さまざまな使用例に対して、特定の言語またはスクリプトのフォントに関する推奨事項のセットを提供します。

public ref class LanguageFontGroup sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.Fonts.ILanguageFontGroupFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class LanguageFontGroup final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.Fonts.ILanguageFontGroupFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LanguageFontGroup final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.Fonts.ILanguageFontGroupFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class LanguageFontGroup
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.Fonts.ILanguageFontGroupFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LanguageFontGroup
function LanguageFontGroup(languageTag)
Public NotInheritable Class LanguageFontGroup
継承
Object Platform::Object IInspectable LanguageFontGroup
属性
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

// Get the recommended Japanese fonts for traditional documents and modern documents.
var fonts = new Windows.Globalization.Fonts.LanguageFontGroup("ja-JP");
var traditionalDocumentFont = fonts.TraditionalDocumentFont;
var modernDocumentFont = fonts.ModernDocumentFont;

// Obtain two properties of the traditional document font.
var traditionalDocumentFontFontFamily = traditionalDocumentFont.FontFamily;   // "MS Mincho"
var traditionalDocumentFontScaleFactor = traditionalDocumentFont.ScaleFactor; // 100

// Obtain two properties of the modern document font.
var modernDocumentFontFontFamily = modernDocumentFont.FontFamily;             // "Meiryo"
var modernDocumentFontScaleFactor = modernDocumentFont.ScaleFactor;           // 90

注釈

LanguageFontGroup には、特定の言語またはスクリプトのフォントに関する推奨事項のセットが用意されています。 個別の LanguageFontGroup プロパティとして公開される、特定の LanguageFontGroup によって推奨されるさまざまなフォントは、さまざまな使用例に対応します。

各 LanguageFontGroup プロパティは、その特定のフォントの推奨事項の詳細を提供する LanguageFont オブジェクトを返します。 これらの詳細には、フォント ファミリだけでなく、フォントの太さ、スタイル、ストレッチ属性も含まれます。

重み/スタイル/ストレッチ属性は、一部の使用例では重要ですが、それ以外の場合は重要ではありません。 たとえば、さまざまな UI 使用カテゴリのフォントの推奨事項では、同じフォント ファミリのフォントを使用できますが、重みが異なる場合があります (たとえば、 UITextFont の場合は Segoe UI Semilight、 UICaptionFont の場合は Segoe UI Regular)。 ただし、一部の使用例では、weight/style/stretch 属性は常に "標準" フォント (通常の太さ、通常のスタイル、通常のストレッチ) を示している可能性があります。 このような場合、アプリは、アプリのシナリオに適した場合と同様に、他の重み/スタイル/ストレッチ書式を適用する必要があります。 詳細については、各 LanguageFontGroup プロパティの解説を参照してください。

一部の言語とスクリプトの場合、LanguageFontGroup では、使用例ごとにフォントに関する推奨事項が提供されない場合があります。 たとえば、固定幅フォントは、すべてのスクリプトに対して Windows で提供されるわけではありません。 詳細については、各 LanguageFontGroup プロパティの解説を参照してください。

注意

アプリがこのクラスで使用されている言語タグを 各国語サポート 関数に渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

以降: LanguageFontGroup クラスは、アプリが開発されたターゲット オペレーティング システムと一致するようにフォント グループ データを返します。 そのため、Windows 8 アプリをWindows 8.1に更新すると、アプリで使用されるフォントが変更される可能性があり、UI レイアウトの調整が必要になる場合があります。

コンストラクター

LanguageFontGroup(String)

特定の言語またはスクリプトの LanguageFontGroup オブジェクトを作成します。

プロパティ

DocumentAlternate1Font

DocumentHeadingFont、ModernDocumentFont、および TraditionalDocumentFont によって提供される推奨事項を超えて、ドキュメントで使用するための追加オプションとして推奨されるフォントを取得します。
DocumentAlternate2Font

DocumentHeadingFont、ModernDocumentFont、および TraditionalDocumentFont によって提供される推奨事項を超えて、ドキュメントで使用するための追加オプションとして推奨されるフォントを取得します。
DocumentHeadingFont

ドキュメント見出しで使用するために推奨されるフォントを取得します。
FixedWidthTextFont

固定幅文字の表示に推奨されるフォントを取得します。
ModernDocumentFont

モダン スタイル規則に従って、一般的なドキュメント本文テキストに推奨されるフォントを取得します。
TraditionalDocumentFont

従来のスタイル規則に従って、一般的なドキュメント本文テキストに推奨されるフォントを取得します。
UICaptionFont

一般的な UI 本文テキストよりも小さいサイズで表示される、キャプションなどの特別な UI 要素に推奨されるフォントを取得します。
UIHeadingFont

通常の UI 本文テキストよりもやや大きいサイズで表示される、見出しなどの特別な UI 要素に推奨されるフォントを取得します。
UINotificationHeadingFont

通知や他のアプリ メッセージの見出しなどの特殊な UI 要素に推奨されるフォントを取得します。これは、UI 本文のテキスト サイズで表示されるか、少し大きいだけで UI 本文テキストと区別する必要があります。
UITextFont

一般的な UI 本文テキストに推奨されるフォントを取得します。
UITitleFont

通常の UI 本文テキストよりもはるかに大きなサイズで設定された特別な UI 要素に推奨されるフォントを取得します。

適用対象

こちらもご覧ください