Graphics.ResetTransform Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

Resets the world transformation matrix of this Graphics to the identity matrix.

C#

public void ResetTransform();

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Translates the world transform of the Windows Form by a vector (100, 0).

• Saves the graphics state of the form.

• Resets the world transform of the form to an identity and fills a rectangle with a solid red brush.

• Restores the translated graphics state and fills a rectangle with a solid blue brush.

The result is an untranslated red-filled rectangle and a translated blue-filled rectangle.

C#

private void SaveRestore1(PaintEventArgs e)
{

    // Translate transformation matrix.
    e.Graphics.TranslateTransform(100, 0);

    // Save translated graphics state.
    GraphicsState transState = e.Graphics.Save();

    // Reset transformation matrix to identity and fill rectangle.
    e.Graphics.ResetTransform();
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 100, 100);

    // Restore graphics state to translated state and fill second

    // rectangle.
    e.Graphics.Restore(transState);
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 100, 100);
}

Remarks

The identity matrix represents a transformation with no scaling, rotation, or translation. Resetting the world transformation of this Graphics to the identity matrix means that its world transformation does not change the geometry of transformed items.

Applies to