INPUTD Mnemonic - Create Date Edit (INPUTD) Control




In BBj 4.0 and higher, the 'INPUTD' mnemonic creates a graphical edit control that accepts a date from a user.




INPUTD control ID.


Horizontal position of the upper-left corner of the INPUTD control.


Vertical position of the upper-left corner of the INPUTD control.


Width of the INPUTD control.


Height of the INPUTD control. To create a standard size control, set the h parameter to 0.


Control flags, as follows:








Sets the control to be initially disabled.




Passes the <Enter> key to the parent window.




Passes the <Tab> key to the parent window.




Prompts non-mouse events on the control to highlight the control text.




Sets the control to be initially invisible.




Draws a recessed client edge around the control.




Draws a raised edge around the control.


Output mask. Uses standard BBj DATE mask conventions and provides a check for the data. If mask$ is empty (""), the default date mask from STBL("!DATE") is used. See Date Input for complete rules.


Input rules. If null, the value in STBL("!IRULES") is used as a default.



Flag Bit

Effect on Input if Bit is Set




If a popup calendar is displayed, include a "week number" column.




Use +/- instead of up/down to move to next/previous date.




Causes the system to beep upon entry of invalid data.


Restore value (Julian date, 0 for today, -1 for blank).


Default value (Julian date, 0 for today, -1 for blank).


The 'INPUTD' control is displayed at the x, y, w, h position based on the current units. val is displayed as the initial date value using mask$.

The backspace key may be used to correct typing errors. If at any time the restore command is issued (see STBL("!EDIT")), the value of the restore$ parameter is displayed and may be accepted or edited.

Upon completion of the entry, the entered string is converted to a Julian date. The Julian date is displayed using mask$.

If the user presses the up-arrow key at any point, the next date is calculated and displayed.

If the user presses the down-arrow key at any point, the previous date is calculated and displayed.

If the user presses the CTRL+key currently mapped to the CALENDAR function (see STBL("!EDIT)), a popup calendar is displayed. The user can select a date from this displayed calendar or click the Close box to return to the INPUTD control. The popup calendar is formatted based on the value of STBL("!LOCALE") at the time when the control was created.

INPUTD Clipboard Operations

The INPUTD control processes the standard <Ctrl>+X (Cut), <Ctrl>+C (Copy), and <Ctrl>+V (Paste) clipboard functions. When copying to the clipboard, only the text returned by retrieving the title is copied. The INPUTD control is the edit control used in the grid control and allows for copy and paste operations between INPUTD controls. If the text pasted into an INPUTD control does not mask correctly, the application generates an Error Code Notify event.


The following describes the parameters INPUTD SENDMSG() functions:




Valid SYSGUI channel.


Object ID.


Specific function, described in the SENDMSG() function documentation.


Four-byte integer that contains an argument for a given function.


String argument for a given function.


Context that contains the specified ID. This parameter is only necessary for objects that do not pertain to the current context.

The returned value indicates the success or failure of the operation: $01$ indicates success, while $00$ indicates failure. The error can be requested or is sent via the Notify event. The INPUTD SENDMSG() functions are described in the SENDMSG() documentation.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing


Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.