IPen​.HorizontalZoom [Method]

Zooms centrally into the time span by the given factor.

Defined As

• [VBA] HorizontalZoom(factor As Double)

• [Cicode] HorizontalZoom(REAL factor)

• [C++] HRESULT HorizontalZoom(double factor)

Parameters

factor

[in] Controls the direction and amount the axis will be zoomed. Acceptable zoom values are 0 to 1 (Zoom out) and > 1 (zoom in).

Execution Result

If the function succeeds the return value will be Success. If the argument is bad then the return value will be InvalidArgument. If the argument is out of range then the return value will be InvalidArgument. If the pen is deleted then the return value will be GeneralFailure.

Calling Syntax

Assumes you have passed a valid pen object into the function.

[VBA]

Sub Example(pen As Object)
` Zoom out 50%
pen.HorizontalZoom 0.5
` Undo the Zoom
pen.HorizontalZoom 1.5
End Sub

[Cicode]

FUNCTION Example(OBJECT hPen)
// Zoom out 50%
_ObjectCallMethod(hPen, "HorizontalZoom", 0.5);
// Undo the Zoom
_ObjectCallMethod(hPen, "HorizontalZoom", 2.0);
END

See Also

IPen.VerticalZoom [Method]