Typography クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
一連の Microsoft OpenType 文字体裁プロパティへのアクセスを提供します。 これらのプロパティは、テキスト オブジェクト モデルのプロパティや特定のテキスト コントロールから設定できるように、XAML 添付プロパティとして実装されます。
public ref class Typography sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Typography final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TypographyPublic NotInheritable Class Typography- 継承
- 属性
例
ここでは、文字体裁の値が TextBlock に設定され、スタイル セット 4 を使用してテキストが小さい大文字でレンダリングされます。
<TextBlock Text="Hello, world!"
Typography.Capitals="SmallCaps"
Typography.StylisticSet4="True"/>
TextBlock textBlock1 = new TextBlock();
textBlock1.Text = "Hello, world!";
Windows.UI.Xaml.Documents.Typography.SetCapitals(textBlock1, FontCapitals.SmallCaps);
Windows.UI.Xaml.Documents.Typography.SetStylisticSet4(textBlock1, true);
この例では、Typography.Fraction 添付プロパティが RichTextBlock の Run に設定されています。
<RichTextBlock>
<Paragraph>12 x <Run Typography.Fraction="Slashed">1/3</Run> = 4.</Paragraph>
</RichTextBlock>
注釈
通常、 TextBlock コントロールまたは RichTextBlock コントロールのテキストには、文字体裁添付プロパティを使用します。
注意
これらのプロパティは 、TextBox コントロールまたは RichEditBox コントロールでは使用できません。
Typography オブジェクトは、Microsoft OpenType フォントでサポートされている一連の機能を公開します。 マークアップまたはコードで Typography のプロパティを設定することで、Microsoft OpenType 機能を利用するドキュメントを作成し、必要に応じて要素ごとのレベルでこれらの機能を有効にすることができます。
一部のフォントには、文字セットの一部に対応するスタイルバリアント グリフが含まれています。 スタイル セット内のグリフは、視覚的に調和したり、特定の方法で対話したり、他の方法で共同作業したりするように設計できます。 これらのバリエーションの一部は、特定の規則によって識別されます。たとえば、フォントに随意合字がある場合があります。 この例では、 Typography.DiscretionaryLigatures を true に設定することで、文字体裁の 動作を有効にすることができます。 その他のスタイルのバリエーションは、Microsoft OpenType のセットまたは規則では識別されず、代わりにその特定のフォントの文字体裁のデザインに固有です。 これらのバリアントには、 いずれかの StylisticSet# 添付プロパティを true に設定することでアクセスできます。
注意
可能な限り、 TextBlock は効率的な 高速パスを使用してテキストをレンダリングします。 さまざまな文字体裁添付プロパティの既定値のみが高速パスです。 既定値以外の値では 、テキストレンダリングのために TextBlock が CPU 負荷の高いコード パスにフォールバックする必要があります。 詳細については、 TextBlock コントロール ガイドを参照してください。
XAML 添付プロパティ
文字体裁は、 いくつかの XAML 添付プロパティのホスト サービス クラスです。
添付プロパティへの XAML プロセッサ アクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 XAML 添付プロパティには、Get および Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して GetValue または SetValue を呼び出し、識別子フィールドを依存関係プロパティ識別子として渡すことです。
| 添付プロパティ | 説明 |
|---|---|
| AnnotationAlternates | データ テンプレートの段階的なレンダリング用のヘルパー メソッドを定義する拡張インスタンスを取得または設定します。
|
| 大文字 | 選択したフォントの大文字の形式を示す FontCapitals 値を取得または設定します。
|
| CapitalSpacing | 読みやすくするために、すべてが大文字のテキストのグリフ間隔をグローバルに調整するかどうかを決定する値を取得または設定します。
|
| CaseSensitiveForms | 大文字のグリフに合わせるためにグリフの垂直位置を調整するかどうかを決定する値を取得または設定します。
|
| ContextualAlternates | 表示されているテキストのコンテキストに基づいてカスタムのグリフ フォームを使用できるかどうかを決定する値を取得または設定します。
|
| コンテキスト合字 | コンテキスト合字が有効かどうかを示す値を取得または設定します。
Typography.ContextualLigatures の値が true で 、選択したフォントがコンテキスト合字をサポートしていない場合、文字の既定の形式が表示されます。 |
| ContextualSwashes | コンテキスト巻きひげ形式のインデックスを指定する値を取得または設定します。
|
| 随意合字 | 随意合字が有効かどうかを示す値を取得または設定します。
|
| EastAsianExpertForms | 標準的な日本語フォントの形式が、対応する適切なタイポグラフィの形式に置き換えられているかどうかを決定する値を取得または設定します。
|
| EastAsianLanguage | 特定の書き込みシステムまたは言語に使用されるグリフを示す FontEastAsianLanguage 値を取得または設定します。
|
| EastAsianWidths | 東アジアのフォントのラテン文字の比例幅を示す FontEastAsianWidths 値を取得または設定します。
|
| Fraction | 分数スタイルを示す FontFraction 値を取得または設定します。
|
| HistoricalForms | 歴史的形式が有効かどうかを示す値を取得または設定します。
|
| 履歴合字 | 歴史的合字が有効かどうかを示す値を取得または設定します。
|
| カーニング | カーニングが有効かどうかを示す値を取得または設定します。 カーニングは文字間の間隔を調整して単語の形状を向上させる文字体裁機能です。
|
| 数学Greek | ギリシャ語グリフの標準的なタイポグラフィ フォント形式が、一般的に数学表記で使用される、対応するフォント形式に置き換えられているかどうかを示す値を取得または設定します。
|
| NumeralAlignment | 数字の幅の配置を示す FontNumeralAlignment 値を取得または設定します。
|
| NumeralStyle | 数値代替フォント フォームのレンダリングに使用されるグリフのセットを決定する FontNumeralStyle 値を取得または設定します。
|
| SlashedZero | 公称ゼロ フォント形式をスラッシュ ゼロで置き換えるかどうかを示す値を取得または設定します。
|
| 標準合字 | 標準合字が有効かどうかを示す値を取得または設定します。
|
| StandardSwashes | 標準巻きひげ形式のインデックスを指定する値を取得または設定します。
|
| スタイルAlternates | スタイル上の代替形式のインデックスを指定する値を取得または設定します。
|
| StylisticSet1 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet2 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet3 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet4 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet5 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet6 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet7 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet8 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet9 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet10 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet11 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet12 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet13 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet14 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet15 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet16 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet17 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet18 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet19 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| StylisticSet20 | スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。
|
| バリアント | 使用する標準の文字体裁形式のバリエーションを示す FontVariants 値を取得または設定します。
|
プロパティ
添付プロパティ
| AnnotationAlternates |
データ テンプレートの段階的なレンダリング用のヘルパー メソッドを定義する拡張インスタンスを取得または設定します。 |
| Capitals |
選択したフォントの大文字の形式を示す FontCapitals 値を取得または設定します。 |
| CapitalSpacing |
読みやすくするために、すべてが大文字のテキストのグリフ間隔をグローバルに調整するかどうかを決定する値を取得または設定します。 |
| CaseSensitiveForms |
大文字のグリフに合わせるためにグリフの垂直位置を調整するかどうかを決定する値を取得または設定します。 |
| ContextualAlternates |
表示されているテキストのコンテキストに基づいてカスタムのグリフ フォームを使用できるかどうかを決定する値を取得または設定します。 |
| ContextualLigatures |
コンテキスト合字が有効かどうかを示す値を取得または設定します。 |
| ContextualSwashes |
コンテキスト巻きひげ形式のインデックスを指定する値を取得または設定します。 |
| DiscretionaryLigatures |
随意合字が有効かどうかを示す値を取得または設定します。 |
| EastAsianExpertForms |
標準的な日本語フォントの形式が、対応する適切なタイポグラフィの形式に置き換えられているかどうかを決定する値を取得または設定します。 |
| EastAsianLanguage |
特定の書き込みシステムまたは言語に使用されるグリフを示す FontEastAsianLanguage 値を取得または設定します。 |
| EastAsianWidths |
東アジアのフォントのラテン文字の比例幅を示す FontEastAsianWidths 値を取得または設定します。 |
| Fraction |
分数スタイルを示す FontFraction 値を取得または設定します。 |
| HistoricalForms |
歴史的形式が有効かどうかを示す値を取得または設定します。 |
| HistoricalLigatures |
歴史的合字が有効かどうかを示す値を取得または設定します。 |
| Kerning |
カーニングが有効かどうかを示す値を取得または設定します。 |
| MathematicalGreek |
ギリシャ語グリフの標準的なタイポグラフィ フォント形式が、一般的に数学表記で使用される、対応するフォント形式に置き換えられているかどうかを示す値を取得または設定します。 |
| NumeralAlignment |
数字の幅の配置を示す FontNumeralAlignment 値を取得または設定します。 |
| NumeralStyle |
数値代替フォント フォームのレンダリングに使用されるグリフのセットを決定する FontNumeralStyle 値を取得または設定します。 |
| SlashedZero |
公称ゼロ フォント形式をスラッシュ ゼロで置き換えるかどうかを示す値を取得または設定します。 |
| StandardLigatures |
標準合字が有効かどうかを示す値を取得または設定します。 |
| StandardSwashes |
標準巻きひげ形式のインデックスを指定する値を取得または設定します。 |
| StylisticAlternates |
スタイル上の代替形式のインデックスを指定する値を取得または設定します。 |
| StylisticSet1 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet10 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet11 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet12 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet13 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet14 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet15 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet16 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet17 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet18 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet19 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet2 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet20 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet3 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet4 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet5 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet6 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet7 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet8 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| StylisticSet9 |
スタイル上のフォント形式セットが有効かどうかを示す値を取得または設定します。 |
| Variants |
使用する標準の文字体裁形式のバリエーションを示す FontVariants 値を取得または設定します。 |
メソッド
適用対象
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示