Rapid-Q Documentation by William Yu (c)1999-2000	Appendix A: QEDIT

QEDIT Component

QEdit is a single-line edit control. More or less used to take input from user.

QEdit Properties

Field	Type	R/W	Default	Support

Align	INTEGER	RW	alNone	W
	Align determines how the control aligns within its parent control.
AutoSize	INTEGER	RW	True	W
	AutoSize determines whether the edit control should adjust its size automatically to accomodate the height of the text.
BorderStyle	INTEGER	RW	bsSingle	W
CharCase	INTEGER	RW	ecNormal	W
	CharCase determines the case of the text within the edit control. 0 = ecNormal -- The text of the edit box displays in mixed case. 1 = ecUpperCase -- The text of the edit box displays in uppercase. 2 = ecLowerCase -- The text of the edit box displays in lowercase.
Color	INTEGER	RW		W
EditText	STRING	RW		W
	EditText is the value of the text for the edit control after it is formatted using InputMask
Enabled	INTEGER	RW	True	WXG
Font	QFONT	W		W
Handle	INTEGER	R		W
Height	INTEGER	RW		WXG
Hint	STRING	RW		WXG
InputMask	STRING	RW		W
	InputMask is the mask that represents what text is valid for the edit control
IsMasked	INTEGER	R	False	W
	IsMasked indicates whether a mask exists for the edit control.
Left	INTEGER	RW	0	WXG
MaxLength	INTEGER	RW	0	WXG
Modified	INTEGER	RW		W
Parent	QFORM/QPANEL/QTABCONTROL	W		WXG
PasswordChar	STRING	RW		W
	PasswordChar indicates the character, if any, to display in place of the actual characters typed in the control. An empty string indicates that text should be displayed normally.
PopupMenu	QPOPUPMENU	W		W
ReadOnly	INTEGER	RW	False	WXG
SelLength	INTEGER	RW		W
SelStart	INTEGER	RW		W
SelText	STRING	RW		W
ShowHint	INTEGER	RW	False	WXG
TabOrder	INTEGER	RW		W
Tag	INTEGER	RW		WXG
Text	STRING	RW		WXG
Top	INTEGER	RW	0	WXG
Visible	INTEGER	RW	True	WXG
Width	INTEGER	RW		WXG

QEdit Events

Event	Type	Occurs when...	Params	Support

OnChange	VOID	Text changed	0	WXG
OnKeyDown	SUB (Key AS WORD, Shift AS INTEGER)	Key held down	2	W
OnKeyPress	SUB (Key AS BYTE)	User presses a key	1	W
OnKeyUp	SUB (Key AS Word, Shift AS INTEGER)	User releases a key	2	W
WndProc	SUB (Hwnd%, Msg%, wParam%, lParam%)	Messages sent to QEdit	4	W

QEdit Examples

  DIM Form AS QForm
  DIM Edit1 AS QEdit

  Edit1.Parent = Form

  Edit1.Text = "Hello"   '' Set as default text
  Form.ShowModal

'--------------------------------------------------------------

' Example on how to handle OnKeyDown event

SUB EditKeyDown (Key AS WORD, Shift AS INTEGER, Sender AS QEDIT)
    SELECT CASE Key
        CASE 27
            SHOWMESSAGE "Escape key pressed!"
        CASE 13
            SHOWMESSAGE "Enter key pressed!"
    END SELECT
END SUB


CREATE Form AS QFORM
    Center
    CREATE Edit AS QEDIT
        OnKeyDown = EditKeyDown
    END CREATE
    ShowModal
END CREATE

QEdit Input Masks

 !      If a ! character appears in the mask, optional characters are represented
        in the EditText as leading blanks. If a ! character is not present, optional
        characters are represented in the EditText as trailing blanks.
 >      If a > character appears in the mask, all characters that follow are in
        uppercase until the end of the mask or until a < character is encountered.
 <      If a < character appears in the mask, all characters that follow are in
        lowercase until the end of the mask or until a > character is encountered.

 <>     If these two characters appear together in a mask, no case checking is
        done and the data is formatted with the case the user uses to enter the data.
 \      The character that follows a \ character is a literal character. Use this
        character to use any of the mask special characters as a literal in the data.
 L      The L character requires an alphabetic character only in this position.
        For the US, this is A-Z, a-z.
 l      The l character permits only an alphabetic character in this position, but
        doesn't require it.

 A      The A character requires an alphanumeric character only in this position.
        For the US, this is A-Z, a-z, 0-9.
 a      The a character permits an alphanumeric character in this position, but
        doesn't require it.
 C      The C character requires an arbitrary character in this position.
 c      The c character permits an arbitrary character in this position, but
        doesn't require it.
 0      The 0 character requires a numeric character only in this position.
 9      The 9 character permits a numeric character in this position, but doesn't
        require it.

 #      The # character permits a numeric character or a plus or minus sign in
        this position, but doesn't require it.
 :      The : character is used to separate hours, minutes, and seconds in times.
        If the character that separates hours, minutes, and seconds is different
        in the regional settings of the Control Panel utility on your computer
        system, that character is used instead.
 /      The / character is used to separate months, days, and years in dates.
        If the character that separates months, days, and years is different
        in the regional settings of the Control Panel utility on your computer
        system, that character is used instead.

 ;      The ; character is used to separate the three fields of the mask.
 _      The _ character automatically inserts spaces into the text. When the
        user enters characters in the field, the cursor skips the _ character.

Prev ComponentContentsNext Component