FormattedText クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows Presentation Foundation (WPF) アプリケーションでのテキストの描画に対する低レベルの制御を提供します。
public ref class FormattedText
public class FormattedText
type FormattedText = class
Public Class FormattedText
- 継承
-
FormattedText
例
次の例では、オブジェクトを FormattedText 作成し、テキストにいくつかの書式設定スタイルを適用します。
protected override void OnRender(DrawingContext drawingContext)
{
string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";
// Create the initial formatted text string.
FormattedText formattedText = new FormattedText(
testString,
CultureInfo.GetCultureInfo("en-us"),
FlowDirection.LeftToRight,
new Typeface("Verdana"),
32,
Brushes.Black);
// Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
formattedText.MaxTextWidth = 300;
formattedText.MaxTextHeight = 240;
// Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
// The font size is calculated in terms of points -- not as device-independent pixels.
formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);
// Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
formattedText.SetFontWeight(FontWeights.Bold, 6, 11);
// Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
formattedText.SetForegroundBrush(
new LinearGradientBrush(
Colors.Orange,
Colors.Teal,
90.0),
6, 11);
// Use an Italic font style beginning at the 28th character and continuing for 28 characters.
formattedText.SetFontStyle(FontStyles.Italic, 28, 28);
// Draw the formatted text string to the DrawingContext of the control.
drawingContext.DrawText(formattedText, new Point(10, 0));
}
Protected Overrides Sub OnRender(ByVal drawingContext As DrawingContext)
Dim testString As String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor"
' Create the initial formatted text string.
Dim formattedText As New FormattedText(testString, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface("Verdana"), 32, Brushes.Black)
' Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
formattedText.MaxTextWidth = 300
formattedText.MaxTextHeight = 240
' Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
' The font size is calculated in terms of points -- not as device-independent pixels.
formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5)
' Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
formattedText.SetFontWeight(FontWeights.Bold, 6, 11)
' Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
formattedText.SetForegroundBrush(New LinearGradientBrush(Colors.Orange, Colors.Teal, 90.0), 6, 11)
' Use an Italic font style beginning at the 28th character and continuing for 28 characters.
formattedText.SetFontStyle(FontStyles.Italic, 28, 28)
' Draw the formatted text string to the DrawingContext of the control.
drawingContext.DrawText(formattedText, New Point(10, 0))
End Sub
注釈
FormattedText オブジェクトを使用すると、複数行のテキストを描画できます。このテキストでは、テキスト内の各文字を個々に書式設定できます。 複数の書式が適用されたテキストを次の例に示します。
書式設定されたテキスト文字列の例
WPF のテキスト機能の観点からは、 FormattedText テキストをグラフィカル要素として処理するため、"低レベル" と見なされます。 WPF のテキストのその他の側面では、テキスト専用のコントロール (、)、フロー ドキュメント モデルを実装する (TextBlock「フロー ドキュメントの概要」を参照)、TextBoxXPS ドキュメント モデルをサポートするコントロールのコンテキストでテキストを処理します (「WPF のドキュメント」を参照)。
のセッター メソッド FormattedText の多くは、 で TextElementサポートされている添付プロパティと類似していますが TextElement 、添付プロパティは flow または XPS の上位レベルのテキスト サポートに適用されます。
コンストラクター
プロパティ
Baseline |
FormattedText オブジェクトの最初の行の上端から最初の行のベースラインまでの距離を取得します。 |
Extent |
最初の行の最上部の描画ピクセルから、最後の行の最下部の描画ピクセルまでの距離を取得します。 |
FlowDirection |
FlowDirection オブジェクトの FormattedText を取得または設定します。 |
Height |
FormattedText オブジェクトの最初の行の上端から最後の行の下端までの距離を示す値を取得します。 |
LineHeight |
テキスト行の行間の高さ (行間隔) を取得します。 |
MaxLineCount |
表示する行の最大数を取得または設定します。 MaxLineCount を超えるテキストは表示されません。 |
MaxTextHeight |
テキスト行の最大の高さを取得または設定します。 |
MaxTextWidth |
テキスト行の最大のテキスト幅 (長さ) を取得または設定します。 |
MinWidth |
指定したテキスト コンテンツをすべて格納できる最小のテキスト幅を取得します。 |
OverhangAfter |
テキストの最後の行の下端から最下部の描画ピクセルまでの距離を取得します。 |
OverhangLeading |
行の先頭の配置ポイントから先頭の描画ピクセルまでの最大距離を取得します。 |
OverhangTrailing |
行の末尾のインク付きピクセルから末尾の配置ポイントまでの最大距離を取得します。 |
PixelsPerDip |
テキストを表示する PixelsPerDip を取得または設定します。 |
Text |
表示されるテキストの文字列を取得します。 |
TextAlignment |
FormattedText オブジェクト内のテキストの配置を取得または設定します。 |
Trimming |
テキストの省略の指定方法を取得または設定します。 |
Width |
行の先頭の配置ポイントから末尾の配置ポイントまでの幅 (末尾の空白文字を除く) を取得します。 |
WidthIncludingTrailingWhitespace |
行の先頭の配置ポイントから末尾の配置ポイントまでの幅 (末尾の空白文字を含む) を取得します。 |
メソッド
適用対象
こちらもご覧ください
.NET