Graphics.EndContainer(GraphicsContainer) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Закрывает текущий графический контейнер и восстанавливает состояние данного объекта 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 создания вложенных графических контейнеров. Графические контейнеры сохраняют графическое состояние, например преобразование, область обрезки и свойства отрисовки.
При вызове BeginContainer метода Graphicsобъекта информационный блок, содержащий состояние Graphics , помещается в стек. Метод BeginContainer возвращает объект , GraphicsContainer который идентифицирует этот информационный блок. При передаче идентифицящего объекта EndContainer в метод информационный блок удаляется из стека и используется для восстановления Graphics до состояния, в которое он находился на момент BeginContainer вызова метода.
Контейнеры могут быть вложенными; То есть метод можно вызвать BeginContainer несколько раз перед вызовом EndContainer метода . Каждый раз при вызове BeginContainer метода в стек помещается информационный блок, и вы получаете для блока сведений GraphicsContainer . При передаче одного из этих объектов EndContainer в метод возвращается в состояние, Graphics в которое он находился во время BeginContainer вызова метода, возвращающего этот конкретный GraphicsContainerобъект . Блок сведений, размещенный в стеке с помощью BeginContainer этого вызова метода, удаляется из стека, а все информационные блоки, размещенные в этом стеке после BeginContainer вызова метода, также удаляются.
Вызовы метода размещают информационные Save блоки в том же стеке, что и вызовы BeginContainer метода . Так же, как EndContainer вызов метода связан с вызовом BeginContainer метода, Restore вызов метода сопряжен с вызовом Save метода.
При вызове EndContainer метода все информационные блоки, размещенные в стеке (методом Save или методом BeginContainer ) после соответствующего BeginContainer вызова метода, удаляются из стека. Аналогичным образом при вызове Restore метода все информационные блоки, размещенные в стеке (методом Save или методом BeginContainer ) после соответствующего Save вызова метода, удаляются из стека.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по