Graphics.EndContainer メソッド

.NET Framework クラス ライブラリ リファレンス

Graphics.EndContainer メソッド

現在のグラフィックス コンテナを閉じ、この Graphics の状態を、BeginContainer メソッドを呼び出すことによって保存されていた状態に復元します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub EndContainer ( _
    container As GraphicsContainer _
)

Visual Basic (使用法)

Dim instance As Graphics
Dim container As GraphicsContainer

instance.EndContainer(container)

C#

public void EndContainer (
    GraphicsContainer container
)

C++

public:
void EndContainer (
    GraphicsContainer^ container
)

J#

public void EndContainer (
    GraphicsContainer container
)

JScript

public function EndContainer (
    container : GraphicsContainer
)

パラメータ

container

このメソッドで復元されるコンテナを表す GraphicsContainer。

解説

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

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

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

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

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

使用例

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

• 新しいグラフィックス コンテナを開き、古いコンテナを保存します。

• コンテナ内のワールド座標を平行移動します。

• 新しいコンテナの (平行移動した座標の) 赤い四角形を塗りつぶします。

• 新しいコンテナを閉じ、保存されているコンテナを復元します。

• 保存されているコンテナの (平行移動していない座標の) 緑の四角形を塗りつぶします。

緑の四角形が同じサイズの赤い四角形の上に重ねられます。

Visual Basic

Public Sub EndContainerState(ByVal
 e As PaintEventArgs)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer
 = _
    e.Graphics.BeginContainer()

    ' Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F)

    ' Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0,
 _
    200, 200)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0, 0,
 _
    200, 200)
End Sub

C#

public void EndContainerState(PaintEventArgs
 e)
{
             
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer();
             
    // Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F);
             
    // Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0,
 200, 200);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0, 0,
 200, 200);
}

C++

public:
   void EndContainerState( PaintEventArgs^ e )
   {
      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer();

      // Translate world transformation.
      e->Graphics->TranslateTransform( 100.0F, 100.0F );

      // Fill translated rectangle in container with red.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 200,
 200 );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0, 0, 200,
 200 );
   }

J#

public void EndContainerState(PaintEventArgs
 e) 
{
    // Begin graphics container.
    GraphicsContainer containerState = e.get_Graphics().BeginContainer();

    // Translate world transformation.
    e.get_Graphics().TranslateTransform(100, 100);

    // Fill translated rectangle in container with red.
    e.get_Graphics().FillRectangle(new SolidBrush(Color.get_Red()),
 0, 0,
        200, 200);

    // End graphics container.
    e.get_Graphics().EndContainer(containerState);

    // Fill untransformed rectangle with green.
    e.get_Graphics().FillRectangle(new SolidBrush(Color.get_Green()),
 0, 0,
        200, 200);
} //EndContainerState

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間