Share via

GetObjectTransform Method

  • Article

GetObjectTransform Method

Gets the InkTransform object that represents the object transform that was used to render ink.

Declaration

[C++]

HRESULT GetObjectTransform(
    [in] IInkTransform* objectTransform
);

[Microsoft® Visual Basic® 6.0]

Public Sub GetObjectTransform( _
    objectTransform As InkTransform _
)

Parameters

objectTransform

[out] The InkTransform object that represents the geometric transformation — rotation, scaling, shear, and reflection — values to use to transform the stroke coordinates within the ink space.

Return Value

HRESULT value Description
S_OK Success.
E_POINTER A parameter contained an invalid pointer.
E_INK_EXCEPTION An exception occurred inside the method.

Remarks

Any translations applied to this transform should be in ink space units (1 unit = .01mm).

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example shows a simple application with one command button named btnRotate on the main form, which when clicked, gets the current object transform matrix from the InkRenderer object in the InkCollector, theInkCollector, and rotates it about the origin by 22.5 degrees, sets the transform back into the InkRenderer, and redraws. This has the effect of rotating the ink clockwise one sixteenth of the way around the origin, so sixteen clicks of the button will bring the ink back to its original position.

Dim theInkCollector As InkCollector

Private Sub btnRotate_Click()
    Dim theInkTransform As InkTransform
    Set theInkTransform = New InkTransform
    theInkCollector.Renderer.GetObjectTransform theInkTransform
    theInkTransform.Rotate 22.5
    theInkCollector.Renderer.SetObjectTransform theInkTransform
    Form1.Refresh
End Sub

Private Sub Form_Load()
    Set theInkCollector = New InkCollector
    theInkCollector.hWnd = Me.hWnd
    theInkCollector.Enabled = True
End Sub

Applies To