HeaderPane
Main
Hide

SftMask/DLL 7.0 - Masked Edit Control

Share Link
Print

Keyboard & Mouse Interface

Masked Edit Control - Keys
+ - * /These characters will invoke the popup calculator if entered in a numeric field which defines a popup calculator.
Alt+Down ArrowIf the caret location is in a date field and the control has a calendar drop down button (see the iEditStyle field), the popup calendar is made visible. If autocomplete entries are available for display, the autocomplete window is displayed.
BackspaceDeletes the current selection (if any) and moves the caret location one position to the left.
Control+AThe entire contents are selected.
Control+CThe currently selected text is copied to the clipboard.
Control+EndMoves the caret location to the last position.
Control+Left ArrowMoves the caret location to the left, stopping after the next encountered group of literals.
Control+Right ArrowMoves the caret location to the right, stopping after the next encountered group of literals.
Control+UThe last action is undone.
Down ArrowIf the caret location is in a numeric input field and the control has up/down buttons, the field value is decremented and/or the NM_SFTMASK_UPDOWNPRESS and NM_SFTMASK_UPDOWNHANDLED notifications are sent. If autocomplete entries are available for display, the list of autocomplete entries is displayed (auto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND) or the first matching saved entry is used to complete the current input (auto_iMode = SFTMASK_AUTOCOMPLETE_APPEND). Otherwise the down arrow key acts like the right arrow key.
EndMoves the caret location beyond the last position where data can be entered.
F4The F4 key is only used if the fAllowF4 field is set to TRUE. If the caret location is in a date field and the control has a calendar drop down button (see the iEditStyle field), the popup calendar is made visible. If a popup calendar or the autocomplete window is active, it is closed.
HomeMoves the caret location to the first position where data can be entered.
InsertToggles between insert and overtype mode (based on the iInputMode field)
Left ArrowMoves the caret location one position to the left.
Right ArrowMoves 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+XThe currently selected text is copied to the clipboard and the selection is deleted.
Shift+F10A popup menu is displayed allowing the user to select cut/paste and undo operations.
Shift+Insert
Control+VThe contents of the clipboard are copied into the control at the caret location, replacing the current selection (if any).
Shift+TabThe Tab key can only be used if the fTabAdvance field 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 dialog manager handles the key, which usually results in the previous control on the dialog receiving the input focus. If fTabAdvance is set to FALSE, the masked edit control does not handle the Tab key.
TabThe Tab key can only be used if the fTabAdvance field 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 dialog manager handles the key, which usually results in the next control on the dialog receiving the input focus. If fTabAdvance is set to FALSE, the masked edit control does not handle the Tab key.
Typed CharactersThese are processed as defined by the edit mask. If a character is typed that is not allowable, the NM_SFTMASK_VALIDATIONERROR notification is sent.
Up ArrowIf the caret location is in a numeric input field and the control has up/down buttons, the field value is incremented and/or the NM_SFTMASK_UPDOWNPRESS and NM_SFTMASK_UPDOWNHANDLED notifications are sent. If autocomplete entries are available for display, the list of autocomplete entries is displayed (auto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND) or the last matching saved entry is used to complete the current input (auto_iMode = SFTMASK_AUTOCOMPLETE_APPEND).
Masked Edit Control - Mouse
Left Mouse ButtonWhen clicking on the masked edit control, the selection behavior is defined using the fEntrySelectMouse and iEntrySelect fields. 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, a drag operation can be started (based on the iDragMode field). 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 (auto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND).
Right Mouse ButtonUsing the right mouse button, a popup menu is displayed allowing the user to select cut/paste and undo operations.
Mouse MovementIf 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 lpszFormattedText field). 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.
CThe current number is cleared.
EnterThe new total is saved, the popup calculator is closed and the total is inserted into the masked edit control field.
EscapeThe popup calculator is closed. The contents of the masked edit control field remain unchanged.
OtherThe edit control used to enter the current number accepts keystrokes as defined valid for a masked edit control.
Shift+TabThe new total is saved, the popup calculator is closed and the total is inserted into the masked edit control field.
TabThe new total is saved, the popup calculator is closed and the total is inserted into the masked edit control field.
PgDnThe following entries are displayed, if the list of entries is scrollable (see the nViewCalcLines field).
PgUpThe previous entries are displayed, if the list of entries is scrollable (see the nViewCalcLines field).
Down ArrowThe list of entries is scrolled down, if the list of entries is scrollable (see the nViewCalcLines field).
Up ArrowThe list of entries is scrolled up, if the list of entries is scrollable (see the nViewCalcLines field).
Popup Calculator - Mouse
ScrollbarClicking on the scrollbar if available (see the nViewCalcLines field) will scroll the list of calculator entries. Otherwise, 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 KeysThe day in the given direction is selected.
Control+PgDnThe next year is displayed and the equivalent day/month is selected.
Control+PgUpThe previous year is displayed and the equivalent day/month is selected.
EndThe last day of the current month is selected.
EnterThe selected date is saved, the popup calendar is closed and the new date is inserted into the masked edit control field(s).
EscapeThe popup calendar is closed. The contents of the masked edit control field(s) remain unchanged.
HomeThe first day of the current month is selected.
PgDnThe next month is displayed and the equivalent day is selected.
PgUpThe previous month is displayed and the equivalent day is selected.
Popup Calendar - Mouse
Left Mouse ButtonClicking 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 month. Clicking on a day selects that day. Depending on the calfSingleClickClose field, 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 Arrowauto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND: If the drop down suggestion list is shown, the next entry in the list is selected. auto_iMode = SFTMASK_AUTOCOMPLETE_APPEND: The next matching saved entry is used to complete the current input.
Up Arrowauto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND: If the drop down suggestion list is shown, the previous entry in the list is selected. auto_iMode = SFTMASK_AUTOCOMPLETE_APPEND: The previous matching saved entry is used to complete the current input.
PgDnauto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND: If the drop down suggestion list is shown, the next set of entries in the list is displayed.
PgUpauto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND: If the drop down suggestion list is shown, the previous set of entries in the list is displayed.
AutoComplete - Mouse
Left Mouse Buttonauto_iMode = SFTMASK_AUTOCOMPLETE_SUGGEST or SFTMASK_AUTOCOMPLETE_SUGGESTAPPEND: 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.

See Also Edit Masks | Popup Calendar | Popup Calculator | AutoComplete


Last Updated 08/30/2026 - (email)
© 2026 Softel vdm, Inc.