Graphics.BeginContainer Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos.

Sobrecargas

BeginContainer()	Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos com a transformação de escala especificada.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos com a transformação de escala especificada.

BeginContainer()

Origem:

Graphics.cs

Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos.

C#

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

Retornos

GraphicsContainer

Esse método retorna um GraphicsContainer que representa o estado dessa Graphics no momento da chamada do método.

Exemplos

O exemplo de código a seguir foi projetado para uso com o 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.

C#

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

Comentários

Use esse método com o método EndContainer para criar contêineres de elementos 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 método BeginContainer de um Graphics, um bloco de informações que contém o estado do Graphics é colocado em uma pilha. O método BeginContainer retorna um GraphicsContainer que identifica esse bloco de informações. Quando você passa o objeto de identificação para o método EndContainer, o bloco de informações é removido da pilha e é usado para restaurar o Graphics para o estado em que estava no momento da chamada do método BeginContainer.

Os contêineres podem ser aninhados; ou seja, você pode chamar o método BeginContainer várias vezes antes de chamar o método EndContainer. Sempre que você chama o método BeginContainer, um bloco de informações é colocado na pilha e você recebe uma GraphicsContainer para o bloco de informações. Quando você passa um desses objetos para o método EndContainer, o Graphics é retornado ao estado em que estava no momento da chamada do método BeginContainer que retornou esse GraphicsContainerespecífico. O bloco de informações colocado na pilha por essa chamada de método BeginContainer é removido da pilha e todos os blocos de informações colocados nessa pilha depois dessa chamada de método BeginContainer também são removidos.

As chamadas para o método Save colocam blocos de informações na mesma pilha que as chamadas para o método BeginContainer. Assim como uma chamada de método EndContainer é emparelhada com uma chamada de método BeginContainer, uma chamada de método Restore é emparelhada com uma chamada de método Save.

Quando você chama o método EndContainer, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente ao método BeginContainer são removidos da pilha. Da mesma forma, quando você chama o método Restore, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente para o método Save são removidos da pilha.

O estado gráfico estabelecido pelo método BeginContainer 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.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Origem:

Graphics.cs

Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos com a transformação de escala especificada.

C#

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

Parâmetros

dstrect

Rectangle

Rectangle estrutura que, juntamente com o parâmetro srcrect, especifica uma transformação de escala para o contêiner.

srcrect

Rectangle

Rectangle estrutura que, juntamente com o parâmetro dstrect, especifica uma transformação de escala para o contêiner.

unit

GraphicsUnit

Membro da enumeração GraphicsUnit que especifica a unidade de medida para o contêiner.

Retornos

GraphicsContainer

Esse método retorna um GraphicsContainer que representa o estado dessa Graphics no momento da chamada do método.

Exemplos

O exemplo de código a seguir foi projetado para uso com o 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.

C#

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

Comentários

Use esse método com o método EndContainer para criar contêineres de elementos 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 método BeginContainer de um Graphics, um bloco de informações que contém o estado do Graphics é colocado em uma pilha. O método BeginContainer retorna um GraphicsContainer que identifica esse bloco de informações. Quando você passa o objeto de identificação para o método EndContainer, o bloco de informações é removido da pilha e é usado para restaurar o Graphics para o estado em que estava no momento da chamada do método BeginContainer.

Os contêineres podem ser aninhados; ou seja, você pode chamar o método BeginContainer várias vezes antes de chamar o método EndContainer. Sempre que você chama o método BeginContainer, um bloco de informações é colocado na pilha e você recebe uma GraphicsContainer para o bloco de informações. Quando você passa um desses objetos para o método EndContainer, o Graphics é retornado ao estado em que estava no momento da chamada do método BeginContainer que retornou esse GraphicsContainerespecífico. O bloco de informações colocado na pilha por essa chamada de método BeginContainer é removido da pilha e todos os blocos de informações colocados nessa pilha depois dessa chamada de método BeginContainer também são removidos.

As chamadas para o método Save colocam blocos de informações na mesma pilha que as chamadas para o método BeginContainer. Assim como uma chamada de método EndContainer é emparelhada com uma chamada de método BeginContainer, uma chamada de método Restore é emparelhada com uma chamada de método Save.

Quando você chama o método EndContainer, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente ao método BeginContainer são removidos da pilha. Da mesma forma, quando você chama o método Restore, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente para o método Save 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 dstrect e srcrect. A escala é igual à transformação que, quando aplicada a srcrect, resulta em dstrect.

O estado gráfico estabelecido pelo método BeginContainer 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.

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Origem:

Graphics.cs

Salva um contêiner de gráficos com o estado atual desse Graphics e abre e usa um novo contêiner de gráficos com a transformação de escala especificada.

C#

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

Parâmetros

dstrect

RectangleF

RectangleF estrutura que, juntamente com o parâmetro srcrect, especifica uma transformação de escala para o novo contêiner de gráficos.

srcrect

RectangleF

RectangleF estrutura que, juntamente com o parâmetro dstrect, especifica uma transformação de escala para o novo contêiner de gráficos.

unit

GraphicsUnit

Membro da enumeração GraphicsUnit que especifica a unidade de medida para o contêiner.

Retornos

GraphicsContainer

Esse método retorna um GraphicsContainer que representa o estado dessa Graphics no momento da chamada do método.

Exemplos

O exemplo de código a seguir foi projetado para uso com o 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.

C#

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

Comentários

Use esse método com o método EndContainer para criar contêineres de elementos 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 método BeginContainer de um Graphics, um bloco de informações que contém o estado do Graphics é colocado em uma pilha. O método BeginContainer retorna um GraphicsContainer que identifica esse bloco de informações. Quando você passa o objeto de identificação para o método EndContainer, o bloco de informações é removido da pilha e é usado para restaurar o Graphics para o estado em que estava no momento da chamada do método BeginContainer.

Os contêineres podem ser aninhados; ou seja, você pode chamar o método BeginContainer várias vezes antes de chamar o método EndContainer. Sempre que você chama o método BeginContainer, um bloco de informações é colocado na pilha e você recebe uma GraphicsContainer para o bloco de informações. Quando você passa um desses objetos para o método EndContainer, o Graphics é retornado ao estado em que estava no momento da chamada do método BeginContainer que retornou esse GraphicsContainerespecífico. O bloco de informações colocado na pilha por essa chamada de método BeginContainer é removido da pilha e todos os blocos de informações colocados nessa pilha depois dessa chamada de método BeginContainer também são removidos.

As chamadas para o método Save colocam blocos de informações na mesma pilha que as chamadas para o método BeginContainer. Assim como uma chamada de método EndContainer é emparelhada com uma chamada de método BeginContainer, uma chamada de método Restore é emparelhada com uma chamada de método Save.

Quando você chama o método EndContainer, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente ao método BeginContainer são removidos da pilha. Da mesma forma, quando você chama o método Restore, todos os blocos de informações colocados na pilha (pelo método Save ou pelo método BeginContainer) após a chamada correspondente para o método Save 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 dstrect e srcrect. A escala é igual à transformação que, quando aplicada a srcrect, resulta em dstrect.

O estado gráfico estabelecido pelo método BeginContainer 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.