Graphics.TranslateTransform Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v9.0.0-rc.1.24451.1

Altera a origem do sistema de coordenadas, acrescentando a tradução especificada para a matriz de transformação deste Graphics.

Sobrecargas

TranslateTransform(Single, Single)	Altera a origem do sistema de coordenadas, acrescentando a tradução especificada para a matriz de transformação deste Graphics.
TranslateTransform(Single, Single, MatrixOrder)	Altera a origem do sistema de coordenadas aplicando a tradução especificada à matriz de transformação desta Graphics na ordem especificada.

TranslateTransform(Single, Single)

Origem:

Graphics.cs

Altera a origem do sistema de coordenadas, acrescentando a tradução especificada para a matriz de transformação deste Graphics.

C#

public void TranslateTransform (float dx, float dy);

Parâmetros

dx

Single

A coordenada x da tradução.

dy

Single

A coordenada y da tradução.

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:

• Gira a matriz de transformação mundial do Windows Form em 30,0F graus.

• Move a origem do objeto gráfico chamando TranslateTransform, acrescentando a tradução para a matriz de transformação.

• Desenha uma elipse traduzida girada com uma caneta azul.

C#

private void TranslateTransformAngle(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to translate, prepending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F);

    // Draw translated, rotated ellipse to screen.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), 0, 0, 200, 80);
}

A ilustração a seguir mostra a saída da execução do exemplo de código anterior.

de reticências traduzidas e transformadas

Comentários

A origem normalmente é o canto superior esquerdo da superfície de desenho. A operação de tradução consiste em multiplicar a matriz de transformação por uma matriz cuja parte de tradução é os parâmetros dx e dy. Esse método aplica a tradução anexando a matriz de tradução à matriz de transformação.

Confira também

• de Sistemas de Coordenadas e Transformações
• usando transformações no GDI+ gerenciado

TranslateTransform(Single, Single, MatrixOrder)

Origem:

Graphics.cs

Altera a origem do sistema de coordenadas aplicando a tradução especificada à matriz de transformação desta Graphics na ordem especificada.

C#

public void TranslateTransform (float dx, float dy, System.Drawing.Drawing2D.MatrixOrder order);

Parâmetros

dx

Single

A coordenada x da tradução.

dy

Single

A coordenada y da tradução.

order

MatrixOrder

Membro da enumeração MatrixOrder que especifica se a tradução é acrescentada ou acrescentada à matriz de transformação.

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:

• Gira a matriz de transformação mundial do Windows Form em 30,0F graus.

• Move a origem do objeto gráfico chamando TranslateTransform, acrescentando a tradução à matriz de transformação mundial.

• Desenha uma elipse girada e traduzida com uma caneta azul.

C#

private void TranslateTransformAngleMatrixOrder(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to translate, appending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F, MatrixOrder.Append);

    // Draw rotated, translated ellipse to screen.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), 0, 0, 200, 80);
}

Comentários

A operação de tradução consiste em multiplicar a matriz de transformação por uma matriz cuja parte de tradução é os parâmetros dx e dy. Esse método acrescenta ou acrescenta a matriz de transformação do Graphics pela matriz de tradução de acordo com o parâmetro order.

Confira também

• de Sistemas de Coordenadas e Transformações
• usando transformações no GDI+ gerenciado