Graphics.EndContainer(GraphicsContainer) Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v9.0.0-preview.5.24306.5

Исходный код:

Graphics.cs

Закрывает текущий графический контейнер и восстанавливает состояние этого Graphics в состояние, сохраненное вызовом метода BeginContainer().

public:
 void EndContainer(System::Drawing::Drawing2D::GraphicsContainer ^ container);

public void EndContainer (System.Drawing.Drawing2D.GraphicsContainer container);

member this.EndContainer : System.Drawing.Drawing2D.GraphicsContainer -> unit

Public Sub EndContainer (container As GraphicsContainer)

Параметры

container

GraphicsContainer

GraphicsContainer, представляющий контейнер, который восстанавливает этот метод.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Открывает новый графический контейнер и сохраняет старый контейнер.

• Преобразует координаты мира в контейнере.

• Заполняет красный прямоугольник в (переведенные координаты нового контейнера).

• Закрывает новый контейнер и восстанавливает сохраненный контейнер.

• Заполняет зеленый прямоугольник (к нетрансляционным координатам) сохраненного контейнера.

Результатом является зеленый прямоугольник, который накладывает красный прямоугольник того же размера.

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 );
   }

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);
}

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

Комментарии

Используйте этот метод с методом BeginContainer для создания вложенных графических контейнеров. Графические контейнеры сохраняют состояние графики, например преобразование, область вырезки и свойства отрисовки.

При вызове метода BeginContainerGraphicsинформационный блок, содержащий состояние Graphics, помещается в стек. Метод BeginContainer возвращает GraphicsContainer, определяющий этот блок информации. При передаче объекта идентификации в метод EndContainer блок информации удаляется из стека и используется для восстановления Graphics в состояние, в которое он был в момент вызова метода BeginContainer.

Контейнеры могут быть вложены; То есть можно вызвать метод BeginContainer несколько раз перед вызовом метода EndContainer. Каждый раз при вызове метода BeginContainer информационный блок помещается в стек, и вы получаете GraphicsContainer для блока информации. При передаче одного из этих объектов методу EndContainerGraphics возвращается в состояние, в которое он был в момент вызова метода BeginContainer, возвращающего этот конкретный GraphicsContainer. Блок сведений, размещенный в стеке с помощью вызова метода BeginContainer, удаляется из стека, а все блоки информации, помещенные в этот стек после вызова метода BeginContainer, также удаляются.

Вызовы метода Save размещают блоки информации в том же стеке, что и вызовы метода BeginContainer. Так же, как вызов метода EndContainer связан с вызовом метода BeginContainer, вызов метода Restore сопряжен с вызовом метода Save.

При вызове метода EndContainer все блоки информации, размещенные в стеке (методом Save или методом BeginContainer), после соответствующего вызова метода BeginContainer удаляются из стека. Аналогичным образом при вызове метода Restore все блоки информации, помещенные в стек (методом Save или методом BeginContainer), после соответствующего вызова метода Save удаляются из стека.