Run クラス

定義

名前空間:

Windows.UI.Xaml.Documents

書式設定されたテキストまたは書式設定されていないテキストの不連続セクションを表します。

public ref class Run sealed : Inline

/// [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.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Run final : Inline

[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.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Run : Inline

Public NotInheritable Class Run
Inherits Inline

<Run .../>
-or-
<Run ...>text</Run>

継承

Object Platform::Object IInspectable DependencyObject TextElement Inline Run

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows の要件

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

例

ここに示す各例では、同じ結果が表示されます。 ただし、TextBlock で Text プロパティを直接設定すると、最適なパフォーマンスが得られます。

<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>

<TextBlock><Run>This is some text.</Run></TextBlock>

<TextBlock><Run Text="This is some text."></Run></TextBlock>

// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";

TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);

注釈

Run は、書式設定されたテキストまたは書式設定されていないテキストの個別のセクションを表し、 TextBlock または RichTextBlock で使用できます。 Span 内に複数の Run 要素を配置できます。

TextBlock を使用する場合は、最適なパフォーマンスを得るには、TextBlock.Text プロパティを直接設定します。 通常、Run 要素は 、TextBlock 内のテキストの個別のセクションを書式設定する場合にのみ使用します。

他の例については、このトピックで後述する「

• TextBlock
• TextBlock コントロール ガイド
• RichTextBlock
• RichTextBlock コントロール ガイド

コンストラクター

Run()

Run クラスの新しいインスタンスを初期化します。

プロパティ

AccessKey	この要素のアクセス キーを取得または設定します。 (継承元 TextElement)
AccessKeyScopeOwner	ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 TextElement)
AllowFocusOnInteraction	ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 TextElement)
CharacterSpacing	em の 1/1000 単位の文字間の均一な間隔を取得または設定します。 (継承元 TextElement)
ContentEnd	要素内のコンテンツの末尾を表す TextPointer を取得します。 (継承元 TextElement)
ContentStart	要素内のコンテンツの開始位置を表す TextPointer を取得します。 (継承元 TextElement)
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
ElementEnd	要素の末尾の直後の位置を表す TextPointer を取得します。 (継承元 TextElement)
ElementStart	要素の開始直前の位置を表す TextPointer を取得します。 (継承元 TextElement)
ExitDisplayModeOnAccessKeyInvoked	アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 TextElement)
FlowDirection	レイアウトを制御する Run 要素内でテキストやその他のユーザー インターフェイス要素が流れる方向を取得または設定します。
FlowDirectionProperty	FlowDirection 依存関係プロパティを識別します。
FontFamily	要素のコンテンツに対して、優先される最上位レベルのフォント ファミリを取得または設定します。 (継承元 TextElement)
FontSize	要素のコンテンツのフォント サイズを取得または設定します。 (継承元 TextElement)
FontStretch	選択するファミリ内のフォントのグリフの幅を取得または設定します。 (継承元 TextElement)
FontStyle	この要素のコンテンツのフォント スタイルを取得または設定します。 (継承元 TextElement)
FontWeight	この要素のコンテンツのフォント ファミリから選択する最上位レベルのフォントの太さを取得または設定します。 (継承元 TextElement)
Foreground	この要素のコンテンツに適用する Brush を取得または設定します。 (継承元 TextElement)
IsAccessKeyScope	要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 TextElement)
IsTextScaleFactorEnabled	システム テキスト サイズの設定を反映するように、自動テキストの拡大を有効にするかどうかを取得または設定します。 (継承元 TextElement)
KeyTipHorizontalOffset	テキスト要素に対してキーヒントを配置する距離を示す値を取得または設定します。 (継承元 TextElement)
KeyTipPlacementMode	KeyTip がテキスト要素に対して配置される場所を示す値を取得または設定します。 (継承元 TextElement)
KeyTipVerticalOffset	テキスト要素に対するキーヒントの配置距離を示す値を取得または設定します。 (継承元 TextElement)
Language	TextElement に適用されるローカライズ/グローバリゼーション言語情報を取得または設定します。 (継承元 TextElement)
Name	オブジェクトの一意の ID を取得または設定します。 名前は、XAML の初期解析からのみ設定できます。 (継承元 TextElement)
Text	Run のテキストの内容を取得または設定 します。
TextDecorations	テキストに適用される装飾を示す値を取得または設定します。 (継承元 TextElement)
XamlRoot	この要素が表示される XamlRoot を取得または設定します。 (継承元 TextElement)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
FindName(String)	オブジェクトの x:Name または Name 属性値を参照して、オブジェクト モデルまたはランタイム オブジェクト グラフ内のオブジェクト を 取得します。 (継承元 TextElement)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
OnDisconnectVisualChildren()	クラス固有のコンテンツまたは子プロパティから項目が削除されたときにレイアウトとロジックがどのように動作するかを実装するには、このメソッドをオーバーライドします。 (継承元 TextElement)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

イベント

AccessKeyDisplayDismissed	アクセス キー のビジュアルを非表示にする必要があることをコントロールに通知するためにアクセス キー シーケンスが完了したときに発生します。 (継承元 TextElement)
AccessKeyDisplayRequested	アクセス キー のビジュアルを表示する必要があることをコントロールに通知するためにアクセス キー シーケンスが開始されたときに発生します。 (継承元 TextElement)
AccessKeyInvoked	ユーザーがアクセス キー シーケンスを完了して、アクセス キー アクションを呼び出す必要があることを要素に通知すると発生します。 (継承元 TextElement)

こちらもご覧ください

• Inline
• TextBlock
• RichTextBlock