GraphicsPath.AddString メソッド (String, FontFamily, Int32, Single, Point, StringFormat)

パスに文字列を追加します。

Overloads Public Sub AddString( _
   ByVal s As String, _   ByVal family As FontFamily, _   ByVal style As Integer, _   ByVal emSize As Single, _   ByVal origin As Point, _   ByVal format As StringFormat _)
[C#]
public void AddString(strings,FontFamilyfamily,intstyle,floatemSize,Pointorigin,StringFormatformat);
[C++]
public: void AddString(String* s,FontFamily* family,intstyle,floatemSize,Pointorigin,StringFormat* format);
[JScript]
public function AddString(
   s : String,family : FontFamily,style : int,emSize : float,origin : Point,format : StringFormat);

パラメータ

• s
  追加する String 。
• family
  テスト描画を行うときに使用するフォントの名前を表す FontFamily オブジェクト。
• style
  テキストに関するスタイル情報 (太字、斜体など) を表す FontStyle 列挙体。この値は、整数としてキャストする必要があります (後のコード例を参照)。
• emSize
  文字の境界を決める Em 正方形ボックスの高さ。
• origin
  テキストを開始する点を表す Point 構造体。
• format
  行間および配置整列など、テキストの書式設定情報を指定する StringFormat オブジェクト。

使用例

[Visual Basic, C#] 次の例は、Windows フォームでの使用を意図してデザインされており、 OnPaint イベントのオブジェクトである PaintEventArgs e が必要です。このコードは次のアクションを実行します。

• パスを作成します。
• 文字列とフォントの引数を設定します。
• パスに文字列を追加します。
• 画面に文字列を描画します。

[Visual Basic, C#] 重要な点が 2 つあります。1 つは、 fontStyle 引数が int としてキャストされることです。 AddString メソッドでは、2 つ以上の FontStyle メンバを組み合わせて希望するフォント スタイル (この場合は Italic と Underline) を作成できるように、このキャストが必要です。もう 1 つは、 DrawPath メソッドではなく FillPath メソッドが使用されることです。 FillPath が使用された場合はソリッド テキストが描画されますが、 DrawPath が使用された場合はテキストがアウトライン スタイルになります。

 
Public Sub AddStringExample(e As PaintEventArgs)
' Create a GraphicsPath object.
Dim myPath As New GraphicsPath()
' Set up all the string parameters.
Dim stringText As String = "Sample Text"
Dim family As New FontFamily("Arial")
Dim myfontStyle As Integer = CInt(FontStyle.Italic)
Dim emSize As Integer = 26
Dim origin As New Point(20, 20)
Dim format As StringFormat = StringFormat.GenericDefault
' Add the string to the path.
myPath.AddString(stringText, family, myfontStyle, emSize, _
origin, format)
'Draw the path to the screen.
e.Graphics.FillPath(Brushes.Black, myPath)
End Sub
        
[C#] 
private void AddStringExample(PaintEventArgs e)
{
// Create a GraphicsPath object.
GraphicsPath myPath = new GraphicsPath();
// Set up all the string parameters.
string stringText = "Sample Text";
FontFamily family = new FontFamily("Arial");
int fontStyle = (int)FontStyle.Italic;
int emSize = 26;
Point origin = new Point(20, 20);
StringFormat format = StringFormat.GenericDefault;
// Add the string to the path.
myPath.AddString(stringText,
family,
fontStyle,
emSize,
origin,
format);
//Draw the path to the screen.
e.Graphics.FillPath(Brushes.Black, myPath);
}
        

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

GraphicsPath クラス | GraphicsPath メンバ | System.Drawing.Drawing2D 名前空間 | GraphicsPath.AddString オーバーロードの一覧