IUP: Driver Information Interface

From IUP - Portable User Interface

Driver Information Interface
[Driver Interface]


Detailed Description

Each driver must export the symbols defined here. But in this case the functions are shared by different drivers in the same system.
For example, the GTK driver and the Windows driver share the same implementation of these functions when the GTK driver is compiled in Windows. The GTK driver and the Motif driver share the same implementation of these functions when the GTK driver is compiled in UNIX.
See iup_drvinfo.h


Functions

void iupdrvGetFullSize (int *width, int *height)
void iupdrvGetScreenSize (int *width, int *height)
int iupdrvGetScreenDepth (void)
char * iupdrvGetSystemVersion (void)
char * iupdrvGetSystemName (void)
char * iupdrvGetComputerName (void)
char * iupdrvGetUserName (void)
void iupdrvGetKeyState (char *key)
void iupdrvGetCursorPos (int *x, int *y)
void * iupdrvGetDisplay (void)
int iupdrvGetWindowDecor (void *wnd, int *border, int *caption)

Function Documentation

void iupdrvGetFullSize (  int *  width,
int *  height
) 
 

Retrieve the main desktop full size.

void iupdrvGetScreenSize (  int *  width,
int *  height
) 
 

Retrieve the main desktop available size.

int iupdrvGetScreenDepth (  void   ) 
 

Retrieve the default desktop bits per pixel.

char* iupdrvGetSystemVersion (  void   ) 
 

Returns a string with the system version number.

char* iupdrvGetSystemName (  void   ) 
 

Returns a string with the system name.

char* iupdrvGetComputerName (  void   ) 
 

Returns a string with the computer name.

char* iupdrvGetUserName (  void   ) 
 

Returns a string with the user name.

void iupdrvGetKeyState (  char *  key  ) 
 

Returns the key state for Shift, Ctrl, Alt and sYs, in this order. Left and right keys are considered. Should declare "char key[5]". Values could be space (" ") or "SCAY".

void iupdrvGetCursorPos (  int *  x,
int *  y
) 
 

Returns the current position of the mouse cursor.

void* iupdrvGetDisplay (  void   ) 
 

Returns the driver "Display" in UNIX and NULL in Windows. Must be implemented somewhere else.

int iupdrvGetWindowDecor (  void *  wnd,
int *  border,
int *  caption
) 
 

Returns the decoration size. In Windows will also includes the menu if any. Used in iupdrvDlgGetDecoration only.