TextBlock クラス (System.Windows.Controls)

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

TextBlock クラス

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

名前空間: System.Windows.Controls
アセンブリ: PresentationFramework (presentationframework.dll 内)
XML 名前空間 : http://schemas.microsoft.com/winfx/2006/xaml/presentation

構文

Visual Basic (宣言)

<ContentPropertyAttribute("Inlines")> _
<LocalizabilityAttribute(LocalizationCategory.Text)> _
Public Class TextBlock
	Inherits FrameworkElement
	Implements IContentHost, IAddChild, IServiceProvider

Visual Basic (使用法)

Dim instance As TextBlock

[ContentPropertyAttribute("Inlines")] 
[LocalizabilityAttribute(LocalizationCategory.Text)] 
public class TextBlock : FrameworkElement, IContentHost, IAddChild, IServiceProvider

C++

[ContentPropertyAttribute(L"Inlines")] 
[LocalizabilityAttribute(LocalizationCategory::Text)] 
public ref class TextBlock : public FrameworkElement, IContentHost, IAddChild, IServiceProvider

/** @attribute ContentPropertyAttribute("Inlines") */ 
/** @attribute LocalizabilityAttribute(LocalizationCategory.Text) */ 
public class TextBlock extends FrameworkElement implements IContentHost, IAddChild, 
	IServiceProvider

JScript

ContentPropertyAttribute("Inlines") 
LocalizabilityAttribute(LocalizationCategory.Text) 
public class TextBlock extends FrameworkElement implements IContentHost, IAddChild, 
	IServiceProvider

XAML オブジェクト要素の使用

<TextBlock>
  Inlines
</TextBlock>

解説

TextBlock は、Inline フローコンテンツ要素のホストおよび表示をサポートします。サポートされている要素には、AnchoredBlock、Bold、Hyperlink、InlineUIContainer、Italic、LineBreak、Run、Span、Underline などがあります。

TextBlock は軽量になるように設計されており、特に少量のフローコンテンツをユーザーインターフェイス (UI) に統合するために使用されます。TextBlock は 1 行を表示するために最適化されており、数行までのコンテンツを表示する場合には優れたパフォーマンスを提供します。

TextBlock は、数行以上のコンテンツを表示する必要があるシナリオには適していません。このようなシナリオでは、FlowDocument を適切な表示コントロールと組み合わせて使用すると、TextBlock より優れたパフォーマンスが得られます。FlowDocumentScrollViewer は TextBlock の次に軽量なフローコンテンツ表示用コントロールであり、最小限の UI を含むスクロールコンテンツエリアを提供します。FlowDocumentPageViewer は、フローコンテンツの "1 ページずつ表示" の表示モードで最適化されています。FlowDocumentReader はフローコンテンツを表示する機能を最も豊富にサポートしていますが、その分ヘビーウェイトになっています。

TextBlock 内でテキストを水平方向および垂直方向に配置するには、HorizontalContentAlignment プロパティおよび VerticalContentAlignment プロパティを使用します。ページのレイアウト内で TextBlock を配置するには、HorizontalAlignment プロパティおよび VerticalAlignment プロパティを使用します。

使用例

TextBlock 要素を使用する方法を次の例に示します。

XAML

<TextBlock Name="textBlock1" TextWrapping="Wrap">
  <Bold>TextBlock</Bold> is designed to be <Italic>lightweight</Italic>,
  and is geared specifically at integrating <Italic>small</Italic> portions
  of flow content into a UI.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>
<TextBlock  Name="textBlock2" 
  TextWrapping="Wrap" Background="AntiqueWhite" TextAlignment="Center"
>
  By default, a TextBlock provides no UI beyond simply displaying its contents.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>

この例の表示結果を次の図に示します。

プログラムによって同様の結果を得る方法を次の例に示します。

TextBlock textBlock1 = new TextBlock();
TextBlock textBlock2 = new TextBlock();

textBlock1.TextWrapping = textBlock2.TextWrapping = TextWrapping.Wrap;
textBlock2.Background = Brushes.AntiqueWhite;
textBlock2.TextAlignment = TextAlignment.Center;

textBlock1.Inlines.Add(new Bold(new Run("TextBlock")));
textBlock1.Inlines.Add(new Run(" is designed to be "));
textBlock1.Inlines.Add(new Italic(new Run("lightweight")));
textBlock1.Inlines.Add(new Run(", and is geared specifically at integrating "));
textBlock1.Inlines.Add(new Italic(new Run("small")));
textBlock1.Inlines.Add(new Run(" portions of flow content into a UI."));

textBlock2.Text =
    "By default, a TextBlock provides no UI beyond simply displaying its contents.";