Reminder

• the input masks that define the characters that can be typed in the controls found in a window or in a page. Sometimes, these masks can also be used to modify the case (uppercase/lowercase characters) of the values assigned to the window controls or to the page controls programmatically.
• the display masks that define the characters that can be printed in the controls found in a report.

In a window or page

• Numeric defined by the project.
• File size.
• Bitcoin.
• Scientific (exponential) notation.
• Percentage.

In a report

• 999,999.99 is associated with Numeric controls.
• +99,999,999.99 is associated with Currency controls.
• +999,999.99 $ is associated with Currency + Euro controls.

• 9': number,
• '.': period,
• ', ': comma,
• '+': plus sign (to allow the signed numbers),
• '-': minus sign used at the end of string to display the negative numbers. To display the "-" sign at the end of string no matter whether the number is positive or negative, specify "--".
• ' ': space,
• 0': to the left of the mask, so that the number is automatically completed with zeros (left),
• '%': percentage. The value displayed (assigned through programming for example) is multiplied by 100 and the % symbol is displayed.
  To display the % sign without multiplying by 100, simply double the acronym % (example: "99.99%%")..
  Important: if in previous versions of WINDEV 9, WEBDEV 9 or WINDEV Mobile 9 (Version 90028 or earlier) you used the % character in your input masks, this character is automatically doubled for compatibility..
  Example:
  Mask 99.99%, input value: 19.6, display value: 19.6%, value manipulated by programming: 0.196.
  Mask 99.99%%, value entered: 19.6, value displayed: 19.6%, value manipulated by programming: 19.6.
• '()': brackets, to display negative numbers.

• the format of positive numbers
• the format of negative numbers
• the value if 0
• the value if NULL

• to one of the following constants: Red, Green, Blue, Black, White, Yellow, Orange
• a hexadecimal value in "#BBGGRR" format.

The '-', '%','()' formats and the advanced custom format are not supported.

Customized input masks are managed in display mode only: they are not available when the user enters the Edit control field.

Hexadecimal input mask
You also have the ability to use a hexadecimal input mask.

Several hexadecimal input masks are proposed:

• 0xFF
• 0xFFFF
• 0xFFFFFFFF
• 0xFFFFFFFFFFFFFFFF

In this case, the control allows you to enter a hexadecimal value ([0-9a-fA-F]) on n characters where n corresponds to the number of F in the mask.

Differences between the Numeric type and the Currency type

Currency + Euro control

• the '' symbol if the current currency is the Euro.
• the caption of the currency (defined in the exchange table by eInitCurrency) if the currency differs from the Euro.

For example: the mask '$999.99' will display '250.25 ' if the current currency is the Euro and '250.25 GBP' if the current currency is the Pound Sterling.

If the currency is displayed in the mask, the currency used will be the one selected in the language options of Windows for the runtime computer.

Remarks

• The "++++" value will be displayed in the control if the following conditions are fulfilled:
  • assignment programmatically.
  • number of digits in the integer part greater than the number of digits in the integer part of the mask.
  For example, if the mask is '99.999' and if the value assigned through programming is '123456', the value "++++" will be displayed in the control.
• The decimal part will be rounded if the following conditions are fulfilled:
  • assignment programmatically.
  • number of digits in the decimal part greater than the number of digits in the decimal part of the mask.
  For example, if the mask is '99.999,99' and if the value assigned through programming is '12345,159', the value "12345,16" will be displayed in the control.

The "System currency" input mask corresponds to the currency mask defined in the preferences of the server.

• assignment programmatically.
• number of digits in the integer part greater than the number of digits in the integer part of the mask.

For example, if the mask is '99.999' and if the value assigned through programming is '123456', the value "++++" will be displayed in the control.