Graphics.BeginContainer Método

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer();

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer();

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

Public Function BeginContainer () As GraphicsContainer

Retornos

Esse método retorna um GraphicsContainer que representa o estado disso Graphics no momento da chamada do 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 manipulador de eventos Paint. O código executa as seguintes ações:

• Abre um novo contêiner gráfico 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.

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

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

Private 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

Comentários

Use esse método com o EndContainer método para criar contêineres gráficos aninhados. Os contêineres gráficos retê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 Graphicsbloco 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 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, ele Graphics é retornado ao estado em que estava no momento da chamada de BeginContainer método que retornou esse determinado 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.

O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; quaisquer alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::Rectangle dstrect, System::Drawing::Rectangle srcrect, System::Drawing::GraphicsUnit unit);

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer(System.Drawing.Rectangle dstrect, System.Drawing.Rectangle srcrect, System.Drawing.GraphicsUnit unit);

member this.BeginContainer : System.Drawing.Rectangle * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer

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

Parâmetros

Retornos

Esse método retorna um GraphicsContainer que representa o estado disso Graphics no momento da chamada do 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 manipulador de eventos Paint. O código executa as seguintes ações:

• Cria dois retângulos para especificar uma transformação de escala para o novo contêiner.

• Abre o novo contêiner de gráficos e salva o contêiner antigo.

• Preenche um retângulo vermelho no novo contêiner (coordenadas dimensionadas).

• Fecha o novo contêiner e restaura o contêiner salvo.

• Preenche um retângulo verde (para as coordenadas não dimensionadas) do contêiner salvo.

O resultado é um retângulo verde que sobrepõe um retângulo vermelho menor.

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

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

Private 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

Comentários

Use esse método com o EndContainer método para criar contêineres gráficos aninhados. Os contêineres gráficos retê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 Graphicsbloco 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 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, ele Graphics é retornado ao estado em que estava no momento da chamada de BeginContainer método que retornou esse determinado 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.

Esse método especifica uma transformação de escala para o novo contêiner de gráficos com os parâmetros e srcrect os dstrect parâmetros. A escala é igual à transformação à srcrectqual, quando aplicada, resulta em dstrect.

O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; quaisquer alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::RectangleF dstrect, System::Drawing::RectangleF srcrect, System::Drawing::GraphicsUnit unit);

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer(System.Drawing.RectangleF dstrect, System.Drawing.RectangleF srcrect, System.Drawing.GraphicsUnit unit);

member this.BeginContainer : System.Drawing.RectangleF * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer

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

Parâmetros

Retornos

Esse método retorna um GraphicsContainer que representa o estado disso Graphics no momento da chamada do 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 manipulador de eventos Paint. O código executa as seguintes ações:

• Cria dois retângulos para especificar uma transformação de escala para o novo contêiner.

• Abre o novo contêiner de gráficos e salva o contêiner antigo.

• Preenche um retângulo vermelho no novo contêiner (coordenadas dimensionadas).

• Fecha o novo contêiner e restaura o contêiner salvo.

• Preenche um retângulo verde (para as coordenadas não dimensionadas) do contêiner salvo.

O resultado é um retângulo verde que sobrepõe um retângulo vermelho menor.

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

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

Private 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

Comentários

Use esse método com o EndContainer método para criar contêineres gráficos aninhados. Os contêineres gráficos retê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 Graphicsbloco 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 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, ele Graphics é retornado ao estado em que estava no momento da chamada de BeginContainer método que retornou esse determinado 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.

Esse método especifica uma transformação de escala para o novo contêiner de gráficos com os parâmetros e srcrect os dstrect parâmetros. A escala é igual à transformação à srcrectqual, quando aplicada, resulta em dstrect.

O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; quaisquer alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.