Graphics.EndContainer(GraphicsContainer) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fecha o contêiner gráfico atual e restaura o estado deste Graphics para o estado salvo por uma chamada ao método 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)
Parâmetros
- container
- GraphicsContainer
GraphicsContainer que representa o contêiner restaurado por esse método.
Exemplos
O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse
, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:
Abre um novo contêiner de gráficos e salva o contêiner antigo.
Converte as coordenadas do mundo no contêiner.
Preenche um retângulo vermelho no novo contêiner (coordenadas traduzidas do).
Fecha o novo contêiner e restaura o contêiner salvo.
Preenche um retângulo verde (para as coordenadas não traduzidas) do contêiner salvo.
O resultado é um retângulo verde que sobrepõe um retângulo vermelho do mesmo tamanho.
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
Comentários
Use esse método com o BeginContainer método para criar contêineres de gráficos aninhados. Os contêineres gráficos mantêm o estado gráfico, como transformação, região de recorte e propriedades de renderização.
Quando você chama o BeginContainer método de um Graphics, um bloco de informações que contém o estado do Graphics é colocado em uma pilha. O BeginContainer método retorna um GraphicsContainer que identifica esse bloco de informações. Quando você passa o objeto de identificação para o EndContainer método , o bloco de informações é removido da pilha e é usado para restaurar o Graphics para o estado em que ele estava no momento da chamada do BeginContainer método.
Os contêineres podem ser aninhados; ou seja, você pode chamar o BeginContainer método várias vezes antes de chamar o EndContainer método . Cada vez que você chama o BeginContainer método , um bloco de informações é colocado na pilha e você recebe um GraphicsContainer para o bloco de informações. Quando você passa um desses objetos para o EndContainer método , o Graphics é retornado ao estado em que estava no momento da chamada de BeginContainer método que retornou esse específico GraphicsContainer. O bloco de informações colocado na pilha por essa BeginContainer chamada de método é removido da pilha e todos os blocos de informações colocados nessa pilha após essa BeginContainer chamada de método também são removidos.
As chamadas para o Save método colocam blocos de informações na mesma pilha que as chamadas para o BeginContainer método . Assim como uma EndContainer chamada de método é emparelhada com uma BeginContainer chamada de método, uma Restore chamada de método é emparelhada com uma Save chamada de método.
Quando você chama o EndContainer método , todos os blocos de informações colocados na pilha (pelo Save método ou pelo BeginContainer método ) após a chamada correspondente ao BeginContainer método são removidos da pilha. Da mesma forma, quando você chama o Restore método , todos os blocos de informações colocados na pilha (pelo Save método ou pelo BeginContainer método) após a chamada correspondente ao Save método são removidos da pilha.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de