次の方法で共有

Graphics.BeginContainer メソッド (RectangleF, RectangleF, GraphicsUnit)

  • [アーティクル]

この Graphics オブジェクトの現在の状態でグラフィックス コンテナを保存し、指定したスケール変換を行った新しいグラフィックス コンテナを開いて使用します。

Overloads Public Function BeginContainer( _
   ByVal dstrect As RectangleF, _   ByVal srcrect As RectangleF, _   ByVal unit As GraphicsUnit _) As GraphicsContainer
[C#]
public GraphicsContainer BeginContainer(RectangleFdstrect,RectangleFsrcrect,GraphicsUnitunit);
[C++]
public: GraphicsContainer* BeginContainer(RectangleFdstrect,RectangleFsrcrect,GraphicsUnitunit);
[JScript]
public function BeginContainer(
   dstrect : RectangleF,srcrect : RectangleF,unit : GraphicsUnit) : GraphicsContainer;

パラメータ

  • dstrect
    srcrect パラメータと共に新しいグラフィックス コンテナのスケール変換を指定する RectangleF 構造体。
  • srcrect
    dstrect パラメータと共に新しいグラフィックス コンテナのスケール変換を指定する RectangleF 構造体。
  • unit
    コンテナの長さの単位を指定する GraphicsUnit 列挙体のメンバ。

戻り値

このメソッドは、メソッドが呼び出された時点での Graphics オブジェクトの状態を表す GraphicsContainer オブジェクトを返します。

解説

入れ子のグラフィックス コンテナを作成するには、このメソッドと共に EndContainer メソッドを使用します。グラフィックス コンテナは、変換、クリッピング領域、レンダリング プロパティなど、グラフィックスの状態を保持します。

Graphics オブジェクトの BeginContainer メソッドを呼び出すと、 Graphics オブジェクトの状態を保持している情報ブロックがスタックに格納されます。 BeginContainer メソッドは、その情報ブロックを識別する GraphicsContainer オブジェクトを返します。識別対象のオブジェクトを EndContainer メソッドに渡すと、情報ブロックはスタックから削除され、 Graphics オブジェクトを BeginContainer メソッド呼び出し時の状態に復元するために使用されます。

コンテナは入れ子にできます。つまり、 EndContainer メソッドを呼び出す前に、 BeginContainer メソッドを複数回呼び出すことができます。 BeginContainer メソッドを呼び出すたびに、情報ブロックがスタックに格納され、その情報ブロックの GraphicsContainer オブジェクトを受け取ります。これらのオブジェクトの 1 つを EndContainer メソッドに渡すと、 Graphics オブジェクトは、その GraphicsContainer オブジェクトを返した BeginContainer メソッドの呼び出し時の状態に戻ります。その BeginContainer メソッドの呼び出しによってスタックに置かれた情報ブロックはスタックから削除されます。さらに、 BeginContainer メソッドの呼び出し後にスタックに置かれたすべての情報ブロックも削除されます。

Graphics.Save メソッドの呼び出しは、 BeginContainer メソッドの呼び出しと同じスタックに情報ブロックを配置します。 EndContainer メソッド呼び出しが BeginContainer メソッド呼び出しと対になっているのと同様に、 Graphics.Restore メソッド呼び出しは Save メソッド呼び出しと対になっています。

EndContainer メソッドを呼び出すと、対応する BeginContainer メソッドの呼び出し後に (Save メソッドまたは BeginContainer メソッドによって) スタックに格納されたすべての情報ブロックが、スタックから削除されます。同様に、Restore メソッドを呼び出すと、対応する Save メソッドの呼び出し後に (Save メソッドまたは BeginContainer メソッドによって) スタックに格納されたすべての情報ブロックが、スタックから削除されます。

このメソッドは、新しいグラフィックス コンテナのスケール変換を dstrect パラメータと srcrect パラメータで指定します。スケールは、 srcrect に適用する場合、 dstrect を生成する変換と等価です。

BeginContainer メソッドが確立するグラフィックスの状態には、既定のグラフィックスの状態のレンダリング品質が含まれます。メソッドの呼び出し以前にレンダリング品質の状態を変更していた場合は、既定値にリセットされます。

使用例

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

  • 新しいコンテナのスケール変換を指定するための四角形を 2 つ作成します。
  • 新しいグラフィックス コンテナを開き、古いコンテナを保存します。
  • 新しいコンテナの (スケーリングされた座標の) 赤い四角形を塗りつぶします。
  • 新しいコンテナを閉じ、保存されているコンテナを復元します。
  • 保存されているコンテナの (スケーリングされていない座標の) 緑の四角形を塗りつぶします。

[Visual Basic, C#] 緑の四角形がそれよりも小さい赤い四角形の上に重ねられます。

 
Public Sub BeginContainerRectangleF(e As PaintEventArgs)
' Define transformation for container.
Dim srcRect As New RectangleF(0F, 0F, 200F, 200F)
Dim destRect As New RectangleF(100F, 100F, 150F, 150F)
' Begin graphics container.
Dim containerState As GraphicsContainer = _
e.Graphics.BeginContainer(destRect, srcRect, GraphicsUnit.Pixel)
' Fill red rectangle in container.
e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0F, 0F, _
200F, 200F)
' End graphics container.
e.Graphics.EndContainer(containerState)
' Fill untransformed rectangle with green.
e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0F, 0F, _
200F, 200F)
End Sub
        
[C#] 
public void BeginContainerRectangleF(PaintEventArgs e)
{
// Define transformation for container.
RectangleF srcRect = new RectangleF(0.0F, 0.0F, 200.0F, 200.0F);
RectangleF destRect = new RectangleF(100.0F, 100.0F, 150.0F, 150.0F);
// Begin graphics container.
GraphicsContainer containerState = e.Graphics.BeginContainer(
destRect, srcRect,
GraphicsUnit.Pixel);
// Fill red rectangle in container.
e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0.0F, 0.0F, 200.0F, 200.0F);
// End graphics container.
e.Graphics.EndContainer(containerState);
// Fill untransformed rectangle with green.
e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0.0F, 0.0F, 200.0F, 200.0F);
}

[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 ファミリ

参照

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