TBApiSetScaleDimensions API Call



Allows a program to specify scaling factors for subsequent calls to TBApiScaleCoordinates. Typically used to map pointer co-ordinates to a window size. This should be called if the window size or position changes.


Scale handle and initial window co-ordinates.


0 = fail, 1 = OK.


The handle should be -1 on the first call. On subsequent calls for the same target the value returned from the first call should be used.


Visual C++ Declaration/example


BOOL TBAPI TBApiSetScaleDimensions(long* handle, unsigned long left, unsigned long top, unsigned long right, unsigned long bottom);


// At window creation


long scaleHandle = -1;

TBApiSetScaleDimensions(&scaleHandle,l,t,r,b); // where l,t,r,b represent the window initial co-ordinates


// Whenever window is moved or resized


TBApiSetScaleDimensions(&scaleHandle,l,t,r,b); // where l,t,r,b represent the new window co-ordinates


// In data callback


unsigned short x,y;


x,y now hold the co-ordinate values from data mapped to the target area


Visual Basic Declaration/example


Public Declare Function TBApiSetScaleDimensions Lib "TBapi" Alias "_DLL_TBApiSetScaleDimensions@20" (ByVal handle As Long, ByVal left As Long, ByVal top As Long, ByVal right As Long, ByVal bottom As Long) As Long