Action
draw a row of keys.
Syntax
CmdKeys x, y, w ,h, font, options, char
Remarks
x |
x-coordinate of keys top-left, in pixels |
y |
y-coordinate of keys top-left, in pixels |
w |
The width of the keys |
h |
The height of the keys |
font |
Bitmap handle to specify the font used in key label. The valid range is from 0 to 31 |
options |
By default the keys are drawn with a 3D effect and the value of option is zero. OPT_FLAT removes the 3D effect. If OPT_CENTER is given the keys are drawn at minimum size centered within the w x h rectangle. Otherwise the keys are expanded so that they completely fill the available space. If an ASCII code is specified, that key is drawn 'pressed' - i.e. in background color with any 3D effect removed. |
char |
Key labels, one character per key. The TAG value is set to the ASCII value of each key, so that key presses can be detected using the REG_TOUCH_TAG register. |
The gap between keys is 3 pixels.
For OPT_CENTERX case, the keys are (font width + 1.5) pixels wide ,otherwise keys are sized to fill available width.
Example
' Pseudocode
' A row of keys
CmdKeys 10, 10, 140, 30, 26, 0, "12345"
' Without the 3D look
CmdKeys 10, 10, 140, 30, 26, OPT_FLAT, "12345"
' Default vs. Centered
CmdKeys 10, 10, 140, 30, 26, 0, "12345"
CmdKeys 10, 60, 140, 30, 26, OPT_CENTER, "12345"
' Setting the options to show '2' key pressed ('2' is ASCII code &H32)
CmdKeys 10, 10, 140, 30, 26, &H32, "12345"
' A calculator-style keyboard using font 29
CmdKeys 22, 1, 116, 28, 29, 0, "789"
CmdKeys 22, 31, 116, 28, 29, 0, "456"
CmdKeys 22, 61, 116, 28, 29, 0, "123"
CmdKeys 22, 91, 116, 28, 29, 0, "0."
' A compact keyboard drawn in font 20
CmdKeys 2, 2, 156, 21, 20, OPT_CENTER, "qwertyuiop"
CmdKeys 2, 26, 156, 21, 20,OPT_CENTER, "asdfghijkl"
CmdKeys 2, 50, 156, 21, 20,OPT_CENTER, "zxcvbnm"
CmdButton 2,74, 156, 21, 20, 0, ""
' Showing the f (ASCII &H66) key pressed
CmdKeys 2, 2, 156, 21, 20, &H66 OR OPT_CENTER, "qwertyuiop"
CmdKeys 2, 26, 156, 21, 20, &H66 OR OPT_CENTER, "asdfghijkl"
CmdKeys 2, 50, 156, 21, 20, &H66 OR OPT_CENTER, "zxcvbnm"
CmdButton 2, 74, 156, 21, 20, 0, ""