Creates a new FormattedEntry widget.
Characters in format
are of two types: writeable: writeable characters which will be replaced with and underscore and where
text will be entered fixed: every other characters are fixed characters, where text cant' be edited, and will be displayed AS IS
Possible values for writeable characters are: <itemizedlist> <listitem><para>'0': digits</para></listitem> <listitem><para>'9': digits excluded 0</para></listitem> <listitem><para>'@': alpha</para> </listitem> <listitem><para>'^': alpha converted to upper case</para></listitem> <listitem><para >'#': alphanumeric</para></listitem> <listitem><para>'*': any char</para></listitem> < /itemizedlist>
if mask
is not null, then it should only contains the follogin characters, which are used
side by side with format
's characters: <itemizedlist> <listitem><para>'_': the corresponding character in
format
is actually used as a writable character</para></listitem> <listitem><para>'-': the
corresponding character in format
is actually used as a writable character, but the character will be removed from
get_text's result if it was not filled by the user</para><
/listitem> <listitem><para>' ': the corresponding character in format
will not be considered as a writable
character but as a non writable character</para></listitem> </itemizedlist> it is then interpreted in the following
way: for a character C in format
, if the character at the same position in mask
is the space character (' '),
then C will not interpreted as a writable format character as defined above. mask
does not be to have the same length as
format
.
format |
a format string |
mask |
a mask string, or null |
the newly created FormattedEntry widget. |