Run クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
書式設定されたテキストまたは書式設定されていないテキストの不連続セクションを表します。
public ref class Run sealed : Inline/// [Windows.Foundation.Metadata.Activatable(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.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
class Run final : 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.Activatable(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.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
public sealed class Run : 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 : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</Run>
- 継承
- 属性
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 内のテキストの個別のセクションを書式設定する場合にのみ使用します。
他の例については、このトピックで後述する「
コンストラクター
| 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) |
メソッド
イベント
| AccessKeyDisplayDismissed |
アクセス キー のビジュアルを非表示にする必要があることをコントロールに通知するためにアクセス キー シーケンスが完了したときに発生します。 (継承元 TextElement) |
| AccessKeyDisplayRequested |
アクセス キー のビジュアルを表示する必要があることをコントロールに通知するためにアクセス キー シーケンスが開始されたときに発生します。 (継承元 TextElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了して、アクセス キー アクションを呼び出す必要があることを要素に通知すると発生します。 (継承元 TextElement) |