www.gnostice.com 

MeasurementUnit

Top  Previous  Next

The MeasurementUnit property specifies the unit of measurement in effect.

 

 

 

 

Syntax

 

 

[VC++]

long GetMeasurementUnit();

void SetMeasurementUnit(long nNewValue);

 

[C#]

public abstract new eDocEngineX.TxgtUnitType MeasurementUnit [  get,  set ]

 

[VB]

Property MeasurementUnit As TxgtUnitType

 

 

 

 

Default Value

 

 

muInches

 

 

 

 

Remarks

 

 

This property specifies the current unit of measurement used in the engine. By default, all measurements are taken in inches. Once this property is set to a particular unit (say, muPixels), all the values provided to the engine will be interpreted in that unit (Pixels). Following are the permitted values for TxgtUnitType:

 

 

 

 

 

 

Unit Type

Description

Values

muPixels

All measurements considered in pixels.

0

muInches

All measurements considered in inches.

1

muPoints

All measurements considered in points.

2

muMM

All measurements considered in millimeters.

3

muTwips

All measurements considered in twips.

4

               

               

       

 

 

 

 

Requirements

 

 

Header: gtDocEnums.h

 

 

 

 

Example Code

 

 

[VC++]

m_Engine.SetFileName("Sample");

m_Engine.BeginDoc();

 

// Set measurement unit to pixels.

m_Engine.SetMeasurementUnit(muPixels);

m_Engine.TextOutXY(100, 100, "Measured in Pixels");

 

// Set measurement unit to inches.

m_Engine.SetMeasurementUnit(muInches);

m_Engine.TextOutXY(1, 3, "Measured in Inches");

 

m_Engine.EndDoc();                        

 

 

 

[VB]

With gtEngineX1

       .FileName = "Sample"

       .BeginDoc

 

       ' Set measurement unit to pixels.

       .MeasurementUnit = muPixels

       .TextOutXY 100, 100, "Measured in Pixels"

 

       ' Set measurement unit to inches.

       .MeasurementUnit = muInches

       .TextOutXY 1, 3, "Measured in Inches"

 

.EndDoc

End With

 

 

[C#]

axgtEngineX1.FileName = "Sample";

axgtEngineX1.BeginDoc();

 

//Set measurement unit to pixels.

 

axgtEngineX1.MeasurementUnit = eDocEngineX.TxgtUnitType.muPixels;

axgtEngineX1.TextOutXY( 100, 100, "Measured in Pixels");

 

//Set measurement unit to inches.

 

axgtEngineX1.MeasurementUnit = eDocEngineX.TxgtUnitType.muPixels;

axgtEngineX1.TextOutXY( 100, 100, "Measured in Pixels");

axgtEngineX1.EndDoc();