この記事は翻訳者によって翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。
訳文
原文
このトピックはまだ評価されていません - このトピックを評価する

TextBlock クラス

少量のテキストを表示する軽量コントロールを提供します。

System.Object
  System.Windows.DependencyObject
    System.Windows.UIElement
      System.Windows.FrameworkElement
        System.Windows.Controls.TextBlock

名前空間:  System.Windows.Controls
アセンブリ :  System.Windows (System.Windows.dll 内)
[ContentPropertyAttribute("Inlines", true)]
public sealed class TextBlock : FrameworkElement
<TextBlock ...>text</TextBlock>
-or-
<TextBlock>
  oneOrMoreInlineElements
</TextBlock>
-or-
<TextBlock .../>

XAML の値

text

TextBlock に表示される内部テキスト。 このテキストが、Text プロパティの値になります。 また、同じテキストを格納する Inlines コレクションに単一の新しい Run オブジェクトが作成されます。

oneOrMoreInlineElements

1 つ以上の Run 要素または LineBreak 要素。

TextBlock 型で公開されるメンバーは以下のとおりです。

  名前 説明
パブリック メソッド Silverlight for Windows Phone によるサポート TextBlock TextBlock クラスの新しいインスタンスを初期化します。
このページのトップへ
  名前 説明
パブリック プロパティ Silverlight for Windows Phone によるサポート ActualHeight FrameworkElement の描画時の高さを取得します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート ActualWidth FrameworkElement の描画時の幅を取得します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート AllowDrop この UIElement を Silverlight でのドラッグ アンド ドロップ操作の対象として使用できるかどうかを判断する値を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート BaselineOffset ベースラインから各テキスト行をオフセットする際の量を返します。
パブリック プロパティ Silverlight for Windows Phone によるサポート CacheMode レンダリングされたコンテンツを可能な場合にキャッシュするように指示する値を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ CharacterSpacing フォント サイズの 1,000 分の 1 の単位で計測される、コントロール内のテキストの文字間の距離を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Clip UIElement のコンテンツのアウトラインの定義に使用する Geometry を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Cursor マウス ポインターが FrameworkElement の上にあるときに表示されるカーソル イメージを取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート DataContext FrameworkElement がデータ バインディングに関与するときにそのデータ コンテキストを取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート DesiredSize レイアウト処理の測定パスの実行中にこの UIElement が計算したサイズを取得します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Dispatcher このオブジェクトに関連付けられている Dispatcher を取得します。 (DependencyObject から継承されます。)
パブリック プロパティ Effect この UIElement のレンダリングに使用されるピクセル シェーダー効果を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート FlowDirection レイアウトを制御する親要素内でのテキストやその他のユーザー インターフェイス要素のフロー方向を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート FontFamily この要素のテキスト コンテンツのトップレベルの優先フォント ファミリを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート FontSize この要素内のテキスト コンテンツのフォント サイズを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート FontSource テキストのコンテンツ表示に適用されるフォント ソースを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート FontStretch この要素内のテキスト コンテンツのフォント伸縮を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート FontStyle この要素のコンテンツのフォント スタイルを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート FontWeight TextBlock のトップレベルのフォントの太さを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Foreground TextBlock のテキスト コンテンツに適用する Brush を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Height FrameworkElement の高さの推奨値を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート HorizontalAlignment FrameworkElement がレイアウトの親 (パネル コントロールや項目コントロールなど) の一部となる場合に適用される水平方向の配置の特性を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Inlines TextBlock 内のインライン テキスト要素のコレクションを取得します。
パブリック プロパティ Silverlight for Windows Phone によるサポート IsHitTestVisible この UIElement が含まれる領域が、ヒット テストに対して true 値を返すかどうかを示す値を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Language FrameworkElement に適用されるローカリゼーション/グローバリゼーション言語情報を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート LineHeight 各コンテンツ行の高さを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート LineStackingStrategy TextBlock の各テキスト行の行ボックスを決定する方法を示す値を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Margin FrameworkElement の外側の余白を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート MaxHeight FrameworkElement の高さの上限を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート MaxWidth FrameworkElement の幅の上限を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート MinHeight FrameworkElement の高さの下限を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート MinWidth FrameworkElement の幅の下限を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Name オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成するとき、実行時のコードからこの名前で、XAML で宣言されたオブジェクトを参照できます。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Opacity オブジェクトの不透明度を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート OpacityMask このオブジェクトの領域の不透明度を変更する場合に使用するブラシを取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Padding コンテンツ エリアの境界と TextBlock によって表示されるコンテンツ間のパディング スペースの太さを示す値を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Parent オブジェクト ツリーにおけるこの FrameworkElement の親オブジェクトを取得します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Projection UIElement のレンダリング時に適用されるパースペクティブ射影 (3-D 効果) を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート RenderSize UIElement の最終的な描画サイズを取得します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート RenderTransform UIElement の描画位置に影響する変換情報を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート RenderTransformOrigin RenderTransform によって宣言された任意の描画変換の、UIElement の境界に対する原点を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Resources ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、frameworkElement.Resources プロパティ要素の子オブジェクト要素としてリソース項目を設定できます。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Style レンダリング中にこのオブジェクトに適用される Style インスタンスを取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Tag オブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Text TextBlock のテキスト コンテンツを取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート TextAlignment テキスト コンテンツの水平方向の配置を示す値を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート TextDecorations TextBlock 要素のコンテンツに適用される文字装飾を指定する値を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート TextTrimming コンテンツ エリアがいっぱいになったときに使用するテキストのトリミング動作を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート TextWrapping TextBlock のテキスト折り返し方法を取得または設定します。
パブリック プロパティ Silverlight for Windows Phone によるサポート Triggers FrameworkElement に対して定義されたアニメーションのトリガーのコレクションを取得します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート UseLayoutRounding オブジェクトとそのビジュアル サブツリーの描画で、描画をピクセル単位に揃える丸め処理を使用するかどうかを決定する値を取得または設定します。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート VerticalAlignment FrameworkElement が親オブジェクト (パネル コントロールや項目コントロールなど) の一部となる場合に適用される垂直方向の配置の特性を取得または設定します。 (FrameworkElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Visibility UIElement の可視性を取得または設定します。 表示されない UIElement は描画されず、レイアウトに対して必要サイズも伝達されません。 (UIElement から継承されます。)
パブリック プロパティ Silverlight for Windows Phone によるサポート Width FrameworkElement の幅を取得または設定します。 (FrameworkElement から継承されます。)
このページのトップへ
  名前 説明
パブリック メソッド Silverlight for Windows Phone によるサポート AddHandler 指定したルーティング イベントのルーティング イベント ハンドラーを、現在の要素のハンドラー コレクションに追加します。 イベント ルート上の他の要素により既に処理済みとしてマークされているルーティング イベントに対し、指定したハンドラーが呼び出されるようにするには、handledEventsTootrue に指定します。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート Arrange 子オブジェクトを配置し、UIElement のサイズを決定します。 子要素に対してカスタム レイアウトを実装する親オブジェクトは、それらのレイアウトのオーバーライド実装からこのメソッドを呼び出し、レイアウトを再帰的に更新する必要があります。 (UIElement から継承されます。)
プロテクト メソッド Silverlight for Windows Phone によるサポート ArrangeOverride Silverlight レイアウトの配置パスの動作を提供します。 クラスはこのメソッドをオーバーライドして、独自の配置パス動作を定義できます。 (FrameworkElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート CaptureMouse UIElement にマウス キャプチャを設定します。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート CheckAccess 呼び出し元のスレッドがこのオブジェクトにアクセスできるかどうかを確認します。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート ClearValue 依存関係プロパティのローカル値をクリアします。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート Equals(Object) 指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。)
プロテクト メソッド Silverlight for Windows Phone によるサポート Finalize Object がガベージ コレクションにより収集される前に、オブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート FindName 指定した識別名を持つオブジェクトを取得します。 (FrameworkElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート GetAnimationBaseValue アニメーションがアクティブでない場合に適用される、Silverlight 依存関係プロパティに対し設定されている基本値を返します。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート GetBindingExpression バインディングが確立された依存関係プロパティの BindingExpression を取得します。 (FrameworkElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート GetHashCode 特定の型のハッシュ関数として機能します。 (Object から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート GetType 現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート GetValue DependencyObject から依存関係プロパティの現在の有効値を返します。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート InvalidateArrange UIElement の配置状態 (レイアウト) を無効にします。 無効にした後、UIElement のレイアウトが更新されます。更新は非同期に行われます。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート InvalidateMeasure UIElement の測定状態 (レイアウト) を無効にします。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート Measure UIElementDesiredSize を更新します。 通常、レイアウトの子のカスタム レイアウトを実装するオブジェクトは、独自の MeasureOverride 実装からこのメソッドを呼び出し、レイアウトを再帰的に更新します。 (UIElement から継承されます。)
プロテクト メソッド Silverlight for Windows Phone によるサポート MeasureOverride Silverlight レイアウトの測定パスの動作を提供します。 クラスはこのメソッドをオーバーライドして、独自の測定パス動作を定義できます。 (FrameworkElement から継承されます。)
プロテクト メソッド Silverlight for Windows Phone によるサポート MemberwiseClone 現在の Object の簡易コピーを作成します。 (Object から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート OnApplyTemplate 派生クラスでオーバーライドされると、アプリケーション コードや内部プロセス (再構築レイアウト パスなど) で ApplyTemplate が呼び出されるたびに呼び出されます。 簡単に言えば、メソッドは、アプリケーションに UI 要素が表示される直前に呼び出されることになります。 詳細については、「解説」を参照してください。 (FrameworkElement から継承されます。)
プロテクト メソッド Silverlight for Windows Phone によるサポート OnCreateAutomationPeer 派生クラスで実装された場合、Silverlight オートメーション インフラストラクチャの、クラス固有の AutomationPeer 実装を返します。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート ReadLocalValue ローカル値が設定されている場合、依存関係プロパティのローカル値を返します。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート ReleaseMouseCapture UIElement からマウス キャプチャを削除します。 この呼び出しの後には、通常、マウス キャプチャを保持しているオブジェクトがなくなります。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート RemoveHandler 指定したルーティング イベント ハンドラーをこの UIElement から削除します。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート SetBinding 指定されたバインディング オブジェクトを使用して FrameworkElement にバインディングをアタッチし、後で使用できるように BindingExpressionBase を返します。 (FrameworkElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート SetValue DependencyObject で依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート ToString 現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート TransformToVisual UIElement から指定したオブジェクトに座標を変換するために使用できる変換オブジェクトを返します。 (UIElement から継承されます。)
パブリック メソッド Silverlight for Windows Phone によるサポート UpdateLayout UIElement の子オブジェクトのすべての位置がレイアウトに対して適切に更新されるようにします。 (UIElement から継承されます。)
このページのトップへ
  名前 説明
パブリック イベント Silverlight for Windows Phone によるサポート BindingValidationError バインディング ソースによってデータの妥当性確認エラーが報告されたときに発生します。 (FrameworkElement から継承されます。)
パブリック イベント DataContextChanged この要素のデータ コンテキストが変更されたときに発生します。 (FrameworkElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート DoubleTap この UIElement 上で DoubleTap ジェスチャが実行されると発生します。 (UIElement から継承されます。)
パブリック イベント DragEnter この要素をドラッグ先とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。)
パブリック イベント DragLeave この要素をドラッグ元とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。)
パブリック イベント DragOver この要素をドロップ先の候補とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。)
パブリック イベント Drop この要素をドロップ先とする、基になるドロップ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート GotFocus UIElement がフォーカスを受け取ったときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート Hold この UIElement 上で Hold ジェスチャが実行されると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート KeyDown UIElement にフォーカスがあるときにキーボード キーが押されると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート KeyUp UIElement にフォーカスがあるときにキーボード キーが離されると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート LayoutUpdated Silverlight のビジュアル ツリーのレイアウトが変化したときに発生します。 (FrameworkElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート Loaded FrameworkElement が構築されてオブジェクト ツリーに追加されたときに発生します。 (FrameworkElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート LostFocus UIElement がフォーカスを失ったときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート LostMouseCapture UIElement でマウスのキャプチャがなくなると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート ManipulationCompleted UIElement の操作および慣性による処理が完了すると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート ManipulationDelta 操作中に入力デバイスが位置を変更したときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート ManipulationStarted 入力デバイスで UIElement の操作を開始すると発生します。 (UIElement から継承されます。)
パブリック イベント MediaCommand リモコンのボタンを押すと発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseEnter マウス (またはスタイラス) が UIElement の境界領域に入ったときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseLeave マウス (またはスタイラス) が UIElement の境界領域を出たときに発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseLeftButtonDown マウス ポインターが UIElement の上にあるときにマウスの左ボタンが押されると (またはスタイラスの先端がタブレットに触れると) 発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseLeftButtonUp マウス (またはスタイラス) が UIElement の上にあるときに (または UIElement がマウス キャプチャを保持しているときに) マウスの左ボタンが離されると (またはスタイラスの先端がタブレットから離れると) 発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseMove マウス (またはスタイラス) が UIElement の上にあるときに (または UIElement がマウス キャプチャを保持しているときに) その座標位置が変更されると発生します。 (UIElement から継承されます。)
パブリック イベント MouseRightButtonDown マウス ポインターが UIElement の上にあるときにマウスの右ボタンが押されると発生します。 (UIElement から継承されます。)
パブリック イベント MouseRightButtonUp マウス ポインターが UIElement の上にあるときにマウスの右ボタンが離されると発生します。 ただし、このイベントが発生するのは、呼び出し元が前の MouseRightButtonDown イベントを処理済みとしてマークした場合のみです。詳細については、「解説」を参照してください。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート MouseWheel マウス ポインターが UIElement 上にあるとき、または UIElement にフォーカスがあるときに、ユーザーがマウス ホイールを回転させると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート SizeChanged FrameworkElementActualHeight プロパティまたは ActualWidth プロパティの値が変更されると発生します。 (FrameworkElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート Tap この UIElement 上で Tap ジェスチャが実行されると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート TextInput デバイスに依存しない方法で UI 要素がテキストを取得すると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート TextInputStart デバイスに依存しない方法で UI 要素が最初にテキストを取得すると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート TextInputUpdate 入力方式エディター (IME) を使用してテキストが引き続き構成されると発生します。 (UIElement から継承されます。)
パブリック イベント Silverlight for Windows Phone によるサポート Unloaded このオブジェクトがメイン オブジェクト ツリーから接続解除されたときに発生します。 (FrameworkElement から継承されます。)
このページのトップへ
  名前 説明
パブリック フィールド 静的メンバー CharacterSpacingProperty CharacterSpacing 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート FontFamilyProperty FontFamily 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート FontSizeProperty FontSize 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート FontStretchProperty FontStretch 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート FontStyleProperty FontStyle 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート FontWeightProperty FontWeight 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート ForegroundProperty Foreground 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート LineHeightProperty LineHeight 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート LineStackingStrategyProperty LineStackingStrategy 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート PaddingProperty Padding 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート TextAlignmentProperty TextAlignment 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート TextDecorationsProperty TextDecorations 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート TextProperty Text 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート TextTrimmingProperty TextTrimming 依存関係プロパティを識別します。
パブリック フィールド 静的メンバー Silverlight for Windows Phone によるサポート TextWrappingProperty TextWrapping 依存関係プロパティを識別します。
このページのトップへ

TextBlock コントロールは、Silverlight ベースのアプリケーションでテキストを表示するための基本要素です。 必須フィールド インジケーターまたは検証エラー インジケーターを含む他のコントロール用のキャプションを表示する必要がある場合は、Label コントロールを使用します。

TextBlock にテキストを設定するときには、XAML で Text プロパティを明示的に指定する必要はありません。 次の例に示すように、TextBlock コンテナーにコンテンツ (内部テキスト) としてテキストを設定できます。

<TextBlock>Hello, world!</TextBlock>
メモメモ :

Text プロパティを設定する場合、前後の空白は保持されません。 XAML での空白の処理の詳細については、「XAML の概要」を参照してください。

親コンテナーのレイアウト内で TextBlock を配置するには、TextAlignmentHorizontalAlignment、および VerticalAlignment の各プロパティを使用します。

また、Run オブジェクトおよび LineBreak オブジェクトを使用すると、XAML における TextBlock の子要素として (またはコードにおける Inlines の項目として)、書式設定されたテキストを表示することもできます。 Run オブジェクトは、書式設定されたテキストまたは書式設定されていないテキストの独立したセクションを表すテキスト要素です。 LineBreak オブジェクトは、TextBlock における明示的な改行を表します。

描画される TextBlockFontSize プロパティの既定値は 11 (ピクセル単位) です。

描画される TextBlockFontFamily プロパティの既定値は "Portable User Interface" です。 "Portable User Interface" の概念の詳細については、「テキストとフォント」を参照してください。

TextBlock テキスト モデル

TextBlock では、単一の文字列を表示する代わりに、それぞれの要素が異なる文字レベル フォント属性を持つ複数の Run 要素に含まれる一連の文字列を表示することができます。 LineBreak オブジェクトは、TextBlock 内の明示的な改行を表し、通常、前後の Run 要素間に使用されます。 LineBreakRun は基本クラス (Inline) を共有するため、テキスト モデル コンテンツの厳密に型指定された InlineCollectionTextBlock が保持することが可能になります。 InlineCollectionTextBlock XAML コンテンツ プロパティでもあります。つまり、TextBlock モデルに項目を指定するには、さまざまな Run 要素および LineBreak 要素を TextBlock の子要素として指定するだけで済みます。

Run オブジェクトを使用してさまざまな書式が設定された複数の文字列を TextBlock に定義する方法を、次の XAML の例に示します。それぞれの文字列は、LineBreak を使用して区切られています。

<!-- Display formatted text as Run objects within a TextBlock. -->
<Canvas>
<TextBlock
  FontFamily="Arial" Width="400" Text="Sample text formatting runs">
  <LineBreak/>
  <Run Foreground="Maroon" FontFamily="Courier New" FontSize="24">Courier New 24</Run>
  <LineBreak/>
  <Run Foreground="Teal" FontFamily="Times New Roman" FontSize="18" FontStyle="Italic">Times New Roman Italic 18</Run>
  <LineBreak/>
  <Run Foreground="SteelBlue" FontFamily="Verdana" FontSize="14" FontWeight="Bold">Verdana Bold 14</Run>
</TextBlock>
</Canvas>

前の XAML コンテンツの例に基づいて書式設定され、レンダリングされたテキストを次の図に示します。

TextBlock rendering multiple Run objects

テキスト書式設定ランのサンプル。

LineBreak により、各 Run 内のテキストは強制的に別の行に表示されます。 LineBreak オブジェクトを指定しないと、各 Run 内のテキストは 1 行にまとめられます。その結果、TextBlock オブジェクトの幅または Silverlight コンテンツ領域の幅を超過したテキストが切り捨てられることもあります。 次の図は、LineBreak オブジェクトを使用しない場合、書式付きテキストがどのようにレンダリングされるかを示します。

LineBreak オブジェクトを使用せずに複数の Run オブジェクトをレンダリングする TextBlock

サンプルのテキスト書式設定ラン。

コードを使用した TextBlock テキスト モデルへのアクセス

TextBlock テキスト モデルに関連するプロパティとして、TextInlines の 2 つがあります。 Text の値を変更することは必ずしも望ましいことではありません。それは、個々の Run 項目の既存のフォント要素の書式設定が平坦化されることに加え、もともとは Text だけではなくインラインと共に作成されていた TextBlockLineBreak 要素が取り除かれる可能性があるためです。 詳細については、「Inlines」を参照してください。

Silverlight

サポート対象 : 5、4、3

Silverlight for Windows Phone

サポート対象 : Windows Phone OS 7.1、Windows Phone OS 7.0

Silverlight でサポートされるオペレーティング システムの詳細については、「サポートされているオペレーティング システムとブラウザー」を参照してください。

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。 インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
この情報は役に立ちましたか。
(残り 1500 文字)
コミュニティ コンテンツ 追加
注釈 FAQ