Functions display dialog allowing user to enter 8-, 16- or 32-bit integer number in any of 3 formats: hexadecimal, decimal unsigned or decimal signed, or (if bit DIA_HEXONLY is set) in hexadecimal format only. Optional checkboxes "Entire block" and "Aligned search" are controlled by bits DIA_ASKGLOBAL and DIA_ALIGNED and control global flags globalsearch and alignedsearch. Return 0 on success and -1 if error occured or user cancelled action. Function Getlongxy additionally contains the preferred screen coordinates of the bottom left point of the dialog window.
int Getlong(char *title,ulong *data,int datasize,char letter,int mode);
int Getlongxy(char *title,ulong *data,int datasize,char letter,int mode,int x,int y);
Parameters:
title - title of dialog box;
data - pointer to 32-bit buffer containing initial value of integer number. On return, buffer contains entered value. If user cancels action, value remains unchanged;
datasize - size of integer number in bytes (1, 2 or 4). Note that dependless on datasize, buffer pointed to by data nust be 32 bits (4 bytes) long;
letter - first character to be entered in default control, or 0 if there is no character. Useful if function is called as a reaction on a character entered by user;
mode - combination of DIA_xxx bits specifying additional Getlong features:
| DIA_HEXONLY | hide decimal input windows |
| DIA_ASKGLOBAL | display checkbox "Entire block" that controls global search flag. Actual state of this flag is returned by call to Plugingetvalue(VAL_GLOBALSEARCH) |
| DIA_ALIGNED | display checkbox "Aligned search" that controls aligned search flag. Actual state of this flag is returned by call to Plugingetvalue(VAL_ALIGNEDSEARCH) |
x - absolute X screen coordinate, in pixels, of the bottom left corner of the dialog window. If necessary, dialog will automatically adjust its position so that it remains visible;
y - absolute Y screen coordinate, in pixels, of the bottom left corner of the dialog window.
See also: Getregxy, Getline, Getfloat, Getfloat10, Getmmx, Get3dnow, Gettableselectionxy