Graphics.BeginContainer 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.
Salva um contêiner de elementos gráficos com o estado atual deste Graphics e abre e usa um novo contêiner de elementos gráficos.
Sobrecargas
BeginContainer() |
Salva um contêiner de elementos gráficos com o estado atual deste Graphics e abre e usa um novo contêiner de elementos gráficos. |
BeginContainer(Rectangle, Rectangle, GraphicsUnit) |
Salva um contêiner gráfico com o estado atual deste Graphics e abre e usa um novo contêiner gráfico com a transformação de escala especificada. |
BeginContainer(RectangleF, RectangleF, GraphicsUnit) |
Salva um contêiner gráfico com o estado atual deste Graphics e abre e usa um novo contêiner gráfico com a transformação de escala especificada. |
BeginContainer()
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
Salva um contêiner de elementos gráficos com o estado atual deste Graphics e abre e usa um novo contêiner de elementos gráficos.
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 deste Graphics no momento da chamada de 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.
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 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.
O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; todas as alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.
Aplica-se a
BeginContainer(Rectangle, Rectangle, GraphicsUnit)
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
Salva um contêiner gráfico com o estado atual deste Graphics e abre e usa um novo contêiner gráfico com a transformação de escala especificada.
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
- dstrect
- Rectangle
A estrutura Rectangle que, juntamente com o parâmetro srcrect
, especifica uma transformação de escala para o contêiner.
- srcrect
- Rectangle
A estrutura Rectangle 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
Esse método retorna um GraphicsContainer que representa o estado deste Graphics no momento da chamada de 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:
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 do).
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 substitui 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 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.
Esse método especifica uma transformação de escala para o novo contêiner de gráficos com os dstrect
parâmetros e srcrect
. A escala é igual à transformação que, quando aplicada a srcrect
, resulta em dstrect
.
O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; todas as alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.
Aplica-se a
BeginContainer(RectangleF, RectangleF, GraphicsUnit)
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
- Origem:
- Graphics.cs
Salva um contêiner gráfico com o estado atual deste Graphics e abre e usa um novo contêiner gráfico com a transformação de escala especificada.
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
- dstrect
- RectangleF
A estrutura RectangleF que, juntamente com o parâmetro srcrect
, especifica uma transformação de escala para o novo contêiner de elementos gráficos.
- srcrect
- RectangleF
A estrutura RectangleF que, juntamente com o parâmetro dstrect
, especifica uma transformação de escala para o novo contêiner de elementos gráficos.
- unit
- GraphicsUnit
Membro da enumeração GraphicsUnit que especifica a unidade de medida para o contêiner.
Retornos
Esse método retorna um GraphicsContainer que representa o estado deste Graphics no momento da chamada de 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:
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 do).
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 substitui 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 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.
Esse método especifica uma transformação de escala para o novo contêiner de gráficos com os dstrect
parâmetros e srcrect
. A escala é igual à transformação que, quando aplicada a srcrect
, resulta em dstrect
.
O estado gráfico estabelecido pelo BeginContainer método inclui as qualidades de renderização do estado gráfico padrão; todas as alterações de estado de qualidade de renderização existentes quando o método é chamado são redefinidas para os valores padrão.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários