TextElement クラス

定義

public ref class TextElement : DependencyObject

/// [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 TextElement : DependencyObject

[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 class TextElement : DependencyObject

Public Class TextElement
Inherits DependencyObject

継承

Object Platform::Object IInspectable DependencyObject TextElement

派生

Microsoft.UI.Xaml.Documents.Block

Microsoft.UI.Xaml.Documents.Inline

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

TextElement によって定義されるさまざまなプロパティは、XAML テキスト オブジェクト モデルに関連するクラスの共通 API をサポートしています。 最もよく使用されるプロパティの一覧を次に示します。

• FontFamily
• FontSize
• FontStretch
• 前景

TextElement プロパティを設定すると、ブロック内とインラインの両方で、テキストに共通のテキスト書式設定プロパティを適用できます。 テキストの書式を設定する他の方法もありますが、これらは TextElement では直接サポートされていません。 代わりに、 Typography クラスの添付プロパティを使用できます。 文字体裁 添付プロパティは、通常、フォント レベルで定義されている文字体裁機能にアクセスするなど、すべてのフォントで必ずしもサポートされていない高度な文字体裁機能や規則をサポートします。 たとえば、 Typography.Variants を任意のテキスト ブロックまたはインラインの添付プロパティとして設定できます。これにより、そのテキスト要素に FontFamily を設定するために選択した特定のフォントで有効になっているフォントバリアントの動作に影響します。

TextElement では、XAML ビジュアル ツリーへの接続ポイントは本質的に定義されません。 言い換えると、TextElement はそのテキスト内でテキストおよびテキスト オブジェクト モデルを定義しますが、UI 内でそのテキストの表示はまだ有効になっていません。 そのためには、 UIElement の子孫であり、XAML ツリーとアプリ ウィンドウのルート ビジュアルに接続できるコントロールまたは要素のいずれかを使用する必要があります。 Windows ランタイムには、次の 2 つの要素があります。

• TextBlock: Inlines コレクションでのみインラインのテキスト オブジェクト モデルをサポートします。
• RichTextBlock: Blocks コレクションを使用してブロック テキスト オブジェクト モデルをサポートします。 ブロックには、ブロックとインラインを含めることができます。

TextElement は、XAML の解析後にテキスト オブジェクト モデルをプログラミング オブジェクトとして調べることをサポートする API を定義します。 特に TextElement は、FrameworkElement で同じ名前の並列プロパティである Name と Language を実装します。 TextElement には、 FindName (初期 XAML で Name がどのように設定されたかに基づいて実行時にオブジェクトを検索するためのユーティリティ メソッド) と OnDisconnectVisualChildren (高度なシナリオとデザイナーのサポート用) も実装されています。

TextElement には、テキスト内から TextPointer オブジェクトへのアクセスを提供する 4 つのプロパティがあります。 これらのプロパティは、 ContentStart、 ContentEnd、 ElementStart、 ElementEnd です。 Windows ランタイム TextPointer オブジェクトは、コンテンツのトラバーサルのエントリ ポイントを提供します。 詳細については、「 TextPointer」を参照してください。

TextElement は DependencyObject から派生したクラスです。 つまり、依存関係プロパティを定義でき、TextElement の各読み取り/書き込みプロパティは依存関係プロパティであり、そのプロパティ識別子も TextElement によって定義されます。 有効な依存関係プロパティの詳細については、「 依存関係プロパティの概要」を参照してください。

TextElement 派生クラス

TextElement は、テキスト オブジェクト モデルを ブロックと インラインの 2 つのテキスト使用規則に分割する 2 つの派生クラスの親クラスです。 ブロック と インライン はどちらも基底クラスと見なされ (通常は XAML にタグは表示 <Block> されません)、主に他の実用的なテキスト要素の親クラスとして階層内に存在します。 たとえば、 Block は Paragraph の親クラスです。 ブロック要素とインライン要素の使用方法の詳細については、「 テキスト ブロック」を参照してください。

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• DependencyObject
• Block
• Inline
• Typography
• テキスト ブロック