FormattedEntry


Description:

[ CCode ( has_construct_function = false , type = "GtkWidget*" ) ]
public FormattedEntry (string format, string? mask)

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.

Parameters:

format

a format string

mask

a mask string, or null

Returns:

the newly created FormattedEntry widget.