Graphics.BeginContainer メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

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

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

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

Visual Basic (宣言)

Public Function BeginContainer ( _
    dstrect As RectangleF, _
    srcrect As RectangleF, _
    unit As GraphicsUnit _
) As GraphicsContainer

Visual Basic (使用法)

Dim instance As Graphics
Dim dstrect As RectangleF
Dim srcrect As RectangleF
Dim unit As GraphicsUnit
Dim returnValue As GraphicsContainer

returnValue = instance.BeginContainer(dstrect, srcrect, unit)

public GraphicsContainer BeginContainer (
    RectangleF dstrect,
    RectangleF srcrect,
    GraphicsUnit unit
)

C++

public:
GraphicsContainer^ BeginContainer (
    RectangleF dstrect, 
    RectangleF srcrect, 
    GraphicsUnit unit
)

public GraphicsContainer BeginContainer (
    RectangleF dstrect, 
    RectangleF srcrect, 
    GraphicsUnit unit
)

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 メソッドの呼び出し後にスタックに置かれたすべての情報ブロックも削除されます。

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

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

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

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

使用例

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

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

緑の四角形がそれよりも小さい赤い四角形の上に重ねられます。

Visual Basic

Public Sub BeginContainerRectangleF(ByVal
 e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New RectangleF(0.0F,
 0.0F, 200.0F, 200.0F)
    Dim destRect As New
 RectangleF(100.0F, 100.0F, 150.0F, 150.0F)

    ' 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), 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)
End Sub

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++

public:
   void BeginContainerRectangleF( PaintEventArgs^ e )
   {
      // Define transformation for container.
      RectangleF srcRect = RectangleF(0.0F,0.0F,200.0F,200.0F);
      RectangleF destRect = 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( gcnew 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( gcnew SolidBrush( Color::Green ), 0.0F, 0.0F,
 200.0F, 200.0F );
   }

プラットフォーム

バージョン情報

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

参照

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

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

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

Visual Basic (宣言)

Public Function BeginContainer ( _
    dstrect As Rectangle, _
    srcrect As Rectangle, _
    unit As GraphicsUnit _
) As GraphicsContainer

Visual Basic (使用法)

Dim instance As Graphics
Dim dstrect As Rectangle
Dim srcrect As Rectangle
Dim unit As GraphicsUnit
Dim returnValue As GraphicsContainer

returnValue = instance.BeginContainer(dstrect, srcrect, unit)

public GraphicsContainer BeginContainer (
    Rectangle dstrect,
    Rectangle srcrect,
    GraphicsUnit unit
)

C++

public:
GraphicsContainer^ BeginContainer (
    Rectangle dstrect, 
    Rectangle srcrect, 
    GraphicsUnit unit
)

public GraphicsContainer BeginContainer (
    Rectangle dstrect, 
    Rectangle srcrect, 
    GraphicsUnit unit
)

JScript

public function BeginContainer (
    dstrect : Rectangle, 
    srcrect : Rectangle, 
    unit : GraphicsUnit
) : GraphicsContainer

パラメータ

dstrect: srcrect パラメータと共にコンテナのスケール変換を指定する Rectangle 構造体。

srcrect: dstrect パラメータと共にコンテナのスケール変換を指定する Rectangle 構造体。

unit: コンテナの長さの単位を指定する GraphicsUnit 列挙体のメンバ。

戻り値
このメソッドは、メソッドが呼び出された時点での Graphics の状態を表す GraphicsContainer を返します。

解説

使用例

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

緑の四角形がそれよりも小さい赤い四角形の上に重ねられます。

Visual Basic

Public Sub BeginContainerRectangle(ByVal
 e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New Rectangle(0,
 0, 200, 200)
    Dim destRect As New
 Rectangle(100, 100, 150, 150)

    ' 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), 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

public void BeginContainerRectangle(PaintEventArgs
 e)
{
    // Define transformation for container.
    Rectangle srcRect = new Rectangle(0, 0, 200, 200);
    Rectangle destRect = new Rectangle(100, 100, 150, 150);
             
    // 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, 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 BeginContainerRectangle( PaintEventArgs^ e )
   {
      // Define transformation for container.
      Rectangle srcRect = Rectangle(0,0,200,200);
      Rectangle destRect = Rectangle(100,100,150,150);

      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer( destRect,
 srcRect, GraphicsUnit::Pixel );

      // Fill red rectangle in container.
      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 );
   }

プラットフォーム

バージョン情報

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

参照

Graphics.BeginContainer メソッド

この Graphics の現在の状態でグラフィックスコンテナを保存し、新しいグラフィックスコンテナを開いて使用します。
オーバーロードの一覧

名前	説明
Graphics.BeginContainer ()	この Graphics の現在の状態でグラフィックスコンテナを保存し、新しいグラフィックスコンテナを開いて使用します。
Graphics.BeginContainer (Rectangle, Rectangle, GraphicsUnit)	この Graphics の現在の状態でグラフィックスコンテナを保存し、指定したスケール変換を行った新しいグラフィックスコンテナを開いて使用します。
Graphics.BeginContainer (RectangleF, RectangleF, GraphicsUnit)	この Graphics の現在の状態でグラフィックスコンテナを保存し、指定したスケール変換を行った新しいグラフィックスコンテナを開いて使用します。

参照

Graphics.BeginContainer メソッド ()

この Graphics の現在の状態でグラフィックスコンテナを保存し、新しいグラフィックスコンテナを開いて使用します。

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

Visual Basic (宣言)

Public Function BeginContainer As
 GraphicsContainer

Visual Basic (使用法)

Dim instance As Graphics
Dim returnValue As GraphicsContainer

returnValue = instance.BeginContainer

public GraphicsContainer BeginContainer ()

C++

public:
GraphicsContainer^ BeginContainer ()

public GraphicsContainer BeginContainer ()

JScript

public function BeginContainer () : GraphicsContainer

戻り値
このメソッドは、メソッドが呼び出された時点での Graphics の状態を表す GraphicsContainer を返します。

解説

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

使用例

新しいグラフィックスコンテナを開き、古いコンテナを保存します。
コンテナ内のワールド座標を平行移動します。
新しいコンテナの (平行移動した座標の) 赤い四角形を塗りつぶします。
新しいコンテナを閉じ、保存されているコンテナを復元します。
保存されているコンテナの (平行移動していない座標の) 緑の四角形を塗りつぶします。

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

Visual Basic

Public Sub BeginContainerVoid(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

public void BeginContainerVoid(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 BeginContainerVoid( 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 );
   }