Keyboard & Mouse Interface

Keyboard & Mouse Interface

Softel vdm, Inc.

Masked Edit Control - Keys

+ — * /

These characters will invoke the popup calculator if entered in a numeric field which defines a popup calculator.

Alt+Down Arrow

If the caret location is in a date field and the control has a calendar drop down button (see EditStyle property), the popup calendar is made visible.

Backspace

Deletes the current selection (if any) and moves the caret location one position to the left.

Control+C

The currently selected text is copied to the clipboard.

Control+End

Moves the caret location to the last position.

Control+Left Arrow

Moves the caret location to the left, stopping after the next encountered group of literals.

Control+Right Arrow

Moves the caret location to the right, stopping after the next encountered group of literals.

Control+U

The last action is undone.

Down Arrow

If the caret location is in a numeric input field and the control has up/down buttons, the field value is decremented and/or the UpDownPress and UpDownHandled events occur.

If autocomplete entries are available for display, the list of autocomplete entries is displayed (AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend) or the first matching saved entry is used to complete the current input (AutoComplete.Mode = autocompleteSftMaskAppend).

Otherwise the down arrow key acts like the right arrow key.

End

Moves the caret location beyond the last position where data can be entered.

F4

The F4 key is only used if the AllowF4 property is set to True.
If the caret location is in a date field and the control has a calendar drop down button (see EditStyle property), the popup calendar is made visible.
If a popup calendar or the autocomplete window is active, it is closed.

Home

Moves the caret location to the first position where data can be entered.

Insert

Toggles between insert and overtype mode (based on InputMode property)

Left Arrow

Moves the caret location one position to the left.

Right Arrow

Moves the caret location one position to the right.

Shift+

The Shift key combined with arrow keys, Home or End keys will extend/shrink the selection as the action defined by the additional key is performed.

Shift+Delete

Control+X

The currently selected text is copied to the clipboard and the selection is deleted.

Shift+F10

A popup menu is displayed allowing the user to select cut/paste and undo operations.

Shift+Insert

Control+V

The contents of the clipboard are copied into the control at the caret location, replacing the current selection (if any).

Shift+Tab

The Tab key can only be used if the TabAdvance property is set to True, in which case Shift+Tab is equivalent to Control+Left arrow. If the caret location is at the first position, the container application can handle the key, which usually results in the previous control on the form/dialog to receive the input focus. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.

If TabAdvance is set to False, the Masked Edit control does not handle the Tab key and the container application can handle the key, which usually results in the previous control on the form/dialog to receive the input focus.

Tab

The Tab key can only be used if the TabAdvance property is set to True, in which case the Tab key is equivalent to Control+Right arrow. If the caret location is at the last position, the container application can handle the key, which usually results in the next control on the form/dialog to receive the input focus. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.

If TabAdvance is set to False, the Masked Edit control does not handle the Tab key and the container application can handle the key, which usually results in the next control on the form/dialog to receive the input focus.

Typed Characters

These are processed as defined by the Mask property. If a character is typed that is not allowable, the ValidationError event occurs.

Up Arrow

If the caret location is in a numeric input field and the control has up/down buttons, the field value is incremented and/or the UpDownPress and UpDownHandled events occur.

If autocomplete entries are available for display, the list of autocomplete entries is displayed (AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend) or the last matching saved entry is used to complete the current input (Mode = autocompleteSftMaskAppend).

Masked Edit Control - Mouse

Left Mouse Button

When clicking on the Masked Edit control, the selection behavior is defined using the EntrySelectMouse and EntrySelect properties.

When clicking on the text of the Masked Edit control, the caret location is changed. If the left mouse button is pressed on the portion of the text that is selected, an OLE drag & drop operation is started (based on the OLEDragMode settings).

When double-clicking on the text of the Masked Edit control, the selection is extended, stopping at the next literal or blank in either direction.

When double-clicking on the text of the Masked Edit control and autocomplete entries are available for display, the list of autocomplete entries is displayed (Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend).

Right Mouse Button

Using the right mouse button, a popup menu is displayed allowing the user to select cut/paste and undo operations.

Mouse Movement

If OLE drag & drop is enabled (see OLEDragMode), an arrow is used as mouse pointer when the cursor is on the selected (highlighted) text indicating that dragging is possible. Otherwise an I-beam is shown.

If the Masked Edit control does not have the input focus and the mouse cursor is moved into the Masked Edit control, the editable text is displayed (replacing the formatted field values and replacing any text that is defined using the FormattedText property). Once the mouse cursor leaves the Masked Edit control, the formatted text is restored.

If the Masked Edit control has the input focus, mouse movement has no noticeable effect (other than the modification of the mouse pointer displayed).

Popup Calculator - Keys

+ — * /

The current number is saved as the current total and a new number can be entered which will be added to the current total (+), subtracted from the current total (-), multiplied by the current total (*) or the total will be divided by the number (/).

=

The new total is saved.

0 - 9 .

These are inserted into the current number.

C

The current number is cleared.

Enter

The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field.

Escape

The popup calculator is closed. The contents of the Masked Edit control field remain unchanged.

Other

The edit control used to enter the current number accepts keystrokes as defined valid for a Masked Edit control.

Shift+Tab

The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.

Tab

The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.

Popup Calculator - Mouse

No mouse events are handled. If the user clicks outside of the popup calculator the new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field.

Popup Calendar - Keys

Arrow Keys

The day in the given direction is selected.

Control+PgDn

The next year is displayed and the equivalent day/month is selected.

Control+PgUp

The previous year is displayed and the equivalent day/month is selected.

End

The last day of the current month is selected.

Enter

The selected date is saved, the popup calendar is closed and the new date is inserted into the Masked Edit control field(s).

Escape

The popup calendar is closed. The contents of the Masked Edit control field(s) remain unchanged.

Home

The first day of the current month is selected.

PgDn

The next month is displayed and the equivalent day is selected.

PgUp

The previous month is displayed and the equivalent day is selected.

Popup Calendar - Mouse

Left Mouse Button

Clicking on the month name displayed in the calendar's title area, a popup menu is displayed from which a new month can be selected which is then displayed.

Clicking on the year displayed in the calendar's title area, up/down buttons are displayed to select a new year, which is then displayed. Keyboard input is not possible to enter a new year.

The buttons displayed in the calendar's title area can be clicked to move to the previous/next year.

Clicking on a day selects that day. Depending on the Calculator.SingleClickClose property, the calendar is closed and the new date is inserted into the Masked Edit control field(s).

Double-clicking on a day of the current month displayed selects that day, closes the calendar and the new date is inserted into the Masked Edit control field(s).

AutoComplete - Keys

Down Arrow

AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend:
If the drop down suggestion list is shown, the next entry in the list is selected.

AutoComplete.Mode = autocompleteSftMaskAppend:
The next matching saved entry is used to complete the current input.

Up Arrow

AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend:
If the drop down suggestion list is shown, the previous entry in the list is selected.

AutoComplete.Mode = autocompleteSftMaskAppend:
The previous matching saved entry is used to complete the current input.

PgDn

AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend:
If the drop down suggestion list is shown, the next set of entries in the list is displayed.

PgUp

AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend:
If the drop down suggestion list is shown, the previous set of entries in the list is displayed.

AutoComplete - Mouse

Left Mouse Button

AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend:
If the drop down suggestion list is shown, clicking on an entry will select and accept the entry, update the control contents and close the drop down list window.

Using the left mouse button, the drop down list can be resized by dragging the resizing box in the bottom right corner of the window.

Masked Edit Control - Keys
+ — * /	These characters will invoke the popup calculator if entered in a numeric field which defines a popup calculator.
Alt+Down Arrow	If the caret location is in a date field and the control has a calendar drop down button (see EditStyle property), the popup calendar is made visible.
Backspace	Deletes the current selection (if any) and moves the caret location one position to the left.
Control+C	The currently selected text is copied to the clipboard.
Control+End	Moves the caret location to the last position.
Control+Left Arrow	Moves the caret location to the left, stopping after the next encountered group of literals.
Control+Right Arrow	Moves the caret location to the right, stopping after the next encountered group of literals.
Control+U	The last action is undone.
Down Arrow	If the caret location is in a numeric input field and the control has up/down buttons, the field value is decremented and/or the UpDownPress and UpDownHandled events occur. If autocomplete entries are available for display, the list of autocomplete entries is displayed (AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend) or the first matching saved entry is used to complete the current input (AutoComplete.Mode = autocompleteSftMaskAppend). Otherwise the down arrow key acts like the right arrow key.
End	Moves the caret location beyond the last position where data can be entered.
F4	The F4 key is only used if the AllowF4 property is set to True. If the caret location is in a date field and the control has a calendar drop down button (see EditStyle property), the popup calendar is made visible. If a popup calendar or the autocomplete window is active, it is closed.
Home	Moves the caret location to the first position where data can be entered.
Insert	Toggles between insert and overtype mode (based on InputMode property)
Left Arrow	Moves the caret location one position to the left.
Right Arrow	Moves the caret location one position to the right.
Shift+	The Shift key combined with arrow keys, Home or End keys will extend/shrink the selection as the action defined by the additional key is performed.
Shift+Delete
Control+X	The currently selected text is copied to the clipboard and the selection is deleted.
Shift+F10	A popup menu is displayed allowing the user to select cut/paste and undo operations.
Shift+Insert
Control+V	The contents of the clipboard are copied into the control at the caret location, replacing the current selection (if any).
Shift+Tab	The Tab key can only be used if the TabAdvance property is set to True, in which case Shift+Tab is equivalent to Control+Left arrow. If the caret location is at the first position, the container application can handle the key, which usually results in the previous control on the form/dialog to receive the input focus. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments. If TabAdvance is set to False, the Masked Edit control does not handle the Tab key and the container application can handle the key, which usually results in the previous control on the form/dialog to receive the input focus.
Tab	The Tab key can only be used if the TabAdvance property is set to True, in which case the Tab key is equivalent to Control+Right arrow. If the caret location is at the last position, the container application can handle the key, which usually results in the next control on the form/dialog to receive the input focus. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments. If TabAdvance is set to False, the Masked Edit control does not handle the Tab key and the container application can handle the key, which usually results in the next control on the form/dialog to receive the input focus.
Typed Characters	These are processed as defined by the Mask property. If a character is typed that is not allowable, the ValidationError event occurs.
Up Arrow	If the caret location is in a numeric input field and the control has up/down buttons, the field value is incremented and/or the UpDownPress and UpDownHandled events occur. If autocomplete entries are available for display, the list of autocomplete entries is displayed (AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend) or the last matching saved entry is used to complete the current input (Mode = autocompleteSftMaskAppend).
Masked Edit Control - Mouse
Left Mouse Button	When clicking on the Masked Edit control, the selection behavior is defined using the EntrySelectMouse and EntrySelect properties. When clicking on the text of the Masked Edit control, the caret location is changed. If the left mouse button is pressed on the portion of the text that is selected, an OLE drag & drop operation is started (based on the OLEDragMode settings). When double-clicking on the text of the Masked Edit control, the selection is extended, stopping at the next literal or blank in either direction. When double-clicking on the text of the Masked Edit control and autocomplete entries are available for display, the list of autocomplete entries is displayed (Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend).
Right Mouse Button	Using the right mouse button, a popup menu is displayed allowing the user to select cut/paste and undo operations.
Mouse Movement	If OLE drag & drop is enabled (see OLEDragMode), an arrow is used as mouse pointer when the cursor is on the selected (highlighted) text indicating that dragging is possible. Otherwise an I-beam is shown. If the Masked Edit control does not have the input focus and the mouse cursor is moved into the Masked Edit control, the editable text is displayed (replacing the formatted field values and replacing any text that is defined using the FormattedText property). Once the mouse cursor leaves the Masked Edit control, the formatted text is restored. If the Masked Edit control has the input focus, mouse movement has no noticeable effect (other than the modification of the mouse pointer displayed).
Popup Calculator - Keys
+ — * /	The current number is saved as the current total and a new number can be entered which will be added to the current total (+), subtracted from the current total (-), multiplied by the current total (*) or the total will be divided by the number (/).
=	The new total is saved.
0 - 9 .	These are inserted into the current number.
C	The current number is cleared.
Enter	The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field.
Escape	The popup calculator is closed. The contents of the Masked Edit control field remain unchanged.
Other	The edit control used to enter the current number accepts keystrokes as defined valid for a Masked Edit control.
Shift+Tab	The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.
Tab	The new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field. The correct operation of this function depends on the container application to provide this functionality and may not be available in all environments.
Popup Calculator - Mouse
No mouse events are handled. If the user clicks outside of the popup calculator the new total is saved, the popup calculator is closed and the total is inserted into the Masked Edit control field.
Popup Calendar - Keys
Arrow Keys	The day in the given direction is selected.
Control+PgDn	The next year is displayed and the equivalent day/month is selected.
Control+PgUp	The previous year is displayed and the equivalent day/month is selected.
End	The last day of the current month is selected.
Enter	The selected date is saved, the popup calendar is closed and the new date is inserted into the Masked Edit control field(s).
Escape	The popup calendar is closed. The contents of the Masked Edit control field(s) remain unchanged.
Home	The first day of the current month is selected.
PgDn	The next month is displayed and the equivalent day is selected.
PgUp	The previous month is displayed and the equivalent day is selected.
Popup Calendar - Mouse
Left Mouse Button	Clicking on the month name displayed in the calendar's title area, a popup menu is displayed from which a new month can be selected which is then displayed. Clicking on the year displayed in the calendar's title area, up/down buttons are displayed to select a new year, which is then displayed. Keyboard input is not possible to enter a new year. The buttons displayed in the calendar's title area can be clicked to move to the previous/next year. Clicking on a day selects that day. Depending on the Calculator.SingleClickClose property, the calendar is closed and the new date is inserted into the Masked Edit control field(s). Double-clicking on a day of the current month displayed selects that day, closes the calendar and the new date is inserted into the Masked Edit control field(s).
AutoComplete - Keys
Down Arrow	AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend: If the drop down suggestion list is shown, the next entry in the list is selected. AutoComplete.Mode = autocompleteSftMaskAppend: The next matching saved entry is used to complete the current input.
Up Arrow	AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend: If the drop down suggestion list is shown, the previous entry in the list is selected. AutoComplete.Mode = autocompleteSftMaskAppend: The previous matching saved entry is used to complete the current input.
PgDn	AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend: If the drop down suggestion list is shown, the next set of entries in the list is displayed.
PgUp	AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend: If the drop down suggestion list is shown, the previous set of entries in the list is displayed.
AutoComplete - Mouse
Left Mouse Button	AutoComplete.Mode = autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend: If the drop down suggestion list is shown, clicking on an entry will select and accept the entry, update the control contents and close the drop down list window. Using the left mouse button, the drop down list can be resized by dragging the resizing box in the bottom right corner of the window.