Graphics.TranslateTransform Metoda

Definicja

Zmienia początek układu współrzędnych, poprzedzając określone tłumaczenie macierzy transformacji tego Graphics.

Przeciążenia

TranslateTransform(Single, Single)

Zmienia początek układu współrzędnych, poprzedzając określone tłumaczenie macierzy transformacji tego Graphics.

TranslateTransform(Single, Single, MatrixOrder)

Zmienia początek układu współrzędnych, stosując określone tłumaczenie do macierzy transformacji tego Graphics w określonej kolejności.

TranslateTransform(Single, Single)

Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Zmienia początek układu współrzędnych, poprzedzając określone tłumaczenie macierzy transformacji tego Graphics.

C#
public void TranslateTransform (float dx, float dy);

Parametry

dx
Single

Współrzędna x tłumaczenia.

dy
Single

Współrzędna y tłumaczenia.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

  • Obraca macierz transformacji świata formularza systemu Windows o 30,0 stopni.

  • Przenosi początek obiektu graficznego, wywołując TranslateTransform, poprzedzając tłumaczenie macierzy transformacji.

  • Rysuje przetłumaczony, obracany wielokropek z niebieskim piórem.

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

Na poniższej ilustracji przedstawiono dane wyjściowe uruchomienia poprzedniego przykładu kodu.

przetłumaczone i przekształcone wielokropek

Uwagi

Początek to zazwyczaj lewy górny róg powierzchni rysunkowej. Operacja tłumaczenia składa się z mnożenia macierzy transformacji przez macierz, której częścią tłumaczenia jest dx i dy parametrów. Ta metoda stosuje tłumaczenie przez poprzedzanie macierzy tłumaczenia do macierzy przekształceń.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

TranslateTransform(Single, Single, MatrixOrder)

Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Zmienia początek układu współrzędnych, stosując określone tłumaczenie do macierzy transformacji tego Graphics w określonej kolejności.

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

Parametry

dx
Single

Współrzędna x tłumaczenia.

dy
Single

Współrzędna y tłumaczenia.

order
MatrixOrder

Element członkowski MatrixOrder wyliczenia, który określa, czy tłumaczenie jest poprzedzane, czy dołączane do macierzy przekształceń.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

  • Obraca macierz transformacji świata formularza systemu Windows o 30,0 stopni.

  • Przenosi początek obiektu graficznego, wywołując TranslateTransform, dołączając tłumaczenie do macierzy transformacji świata.

  • Rysuje obrócony, przetłumaczony wielokropek niebieskim piórem.

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

Uwagi

Operacja tłumaczenia składa się z mnożenia macierzy transformacji przez macierz, której częścią tłumaczenia jest dx i dy parametrów. Ta metoda poprzedza lub dołącza macierz przekształcania Graphics przez macierz tłumaczenia zgodnie z parametrem order.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9