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 Component | Contents | Next Component