Gadget class. More...

#include <ilviews/dataccess/inpmask.h>

Inheritance diagram for IliInputMaskIpl:

Public Member Functions
	IliInputMaskIpl (const char *definition)
	This constructor creates a mask according to one definition. More...

IlBoolean	checkIndexChar (IlInt pos) const
	`IlTrue` if the position is valid. More...

virtual wchar_t	filterChar (IlInt pos, wchar_t c)
	Returns the filtered character which corresponds to a character. More...

virtual IlBoolean	format (IliString &dest, const IliValue &src, IlBoolean forEdit) const
	Uses the mask to format a value. More...

virtual void	formatForClipboard (IliString &dest, const char *src, IlInt startPos) const
	Formats a value for the clipboard. More...

const char *	getDefinition () const
	Increments the reference count for the mask.

IlInt	getFirstEditablePos () const
	Returns the position of the first character that can be edited. More...

IlInt	getLastEditablePos () const
	Returns the position of the last character that can be edited. More...

IlInt	getMaxCharMask () const
	Returns the maximum length of the mask. More...

virtual IlInt	getMaxEntryChar () const
	Returns the maximum number of characters that can be entered. More...

virtual IlInt	getNextEditablePos (IlInt pos) const
	Returns the position of the next character that can be edited. More...

virtual IlInt	getPreviousEditablePos (IlInt pos) const
	Returns the position of the previous character that can be edited. More...

virtual IlBoolean	isConstantChar (IlInt pos) const
	Returns `IlTrue` if a character is Constant. More...

virtual IlBoolean	isFixChar (IlInt pos) const
	Returns `IlTrue` if a character is Fix. More...

virtual IlBoolean	isNeededChar (IlInt pos) const
	Returns `IlTrue` if a character is Standard and Mandatory. More...

virtual IlBoolean	isValidChar (IlInt pos, wchar_t c, IlBoolean editMode) const
	Returns `IlTrue` if a character on the mask is valid. More...

virtual wchar_t	killChar (IlInt pos, wchar_t c)
	Returns the character used to replace a deleted character. More...

void	setMaxCharMask (IlInt v)
	Sets the maximum length of the mask. More...

virtual IlBoolean	unFormat (IliString &dest, const char *src) const
	Unformats a string. More...

Public Member Functions inherited from IliRefCounted
IlInt	getRefCount () const
	Returns the reference count of the object. Initially, this property is set to `0`. More...

void	lock () const
	Increments the reference count of the object.

void	unLock () const
	Decrements the reference count of the object. More...

Static Public Member Functions
static void	AddCustomMask (IliInputMaskIpl *msk)
	Adds a mask into the list of predefined masks. More...

static IliInputMaskIpl *	FindMask (const char *definition)
	Returns a pointer to the mask that corresponds to the definition. More...

static IliInputMaskIpl *	GetNullMask ()
	Returns a pointer to the null mask. More...

static void	RemoveCustomMask (IliInputMaskIpl *msk)
	Removes a mask from the list of predefined masks. More...

Protected Member Functions
virtual const char *	getEffectiveDefinition () const
	Returns the effective definition of the mask. More...

virtual const IliFormat &	getValueFormat () const
	Returns the format used to format the value (from the database) into a string. More...

Protected Member Functions inherited from IliRefCounted
virtual	~IliRefCounted ()
	This is the virtual destructor of the `IliRefCounted` class. More...

Friends
class	IliInputMask

Detailed Description

Gadget class.

Library: dataccess

The IliInputMaskIpl class defines an abstract class to create a mask used to enter data into IliEntryField. The mask defines the different possibilities for each type of character entered. The User's Manual has a sample of this class to help you define your mask. A mask has three types of visible characters:

Standard characters that can be edited.
Constant characters that cannot be edited but can be written into the value.
Fix characters that are just for display. They can be neither edited nor written into the value.

See also: IliInputMask

Constructor & Destructor Documentation

§ IliInputMaskIpl()

IliInputMaskIpl::IliInputMaskIpl ( const char * definition )

This constructor creates a mask according to one definition.

Parameters

definition The definition or an alias.

Member Function Documentation

§ AddCustomMask()

static void IliInputMaskIpl::AddCustomMask ( IliInputMaskIpl * msk )

static

Adds a mask into the list of predefined masks.

Parameters

msk The mask.

§ checkIndexChar()

IlBoolean IliInputMaskIpl::checkIndexChar ( IlInt pos ) const

IlTrue if the position is valid.

Parameters

pos	The position.

Returns: IlTrue if the position pos is valid, otherwise returns IlFalse.

§ filterChar()

virtual wchar_t IliInputMaskIpl::filterChar	(	IlInt	pos,
		wchar_t	c
	)

virtual

Returns the filtered character which corresponds to a character.

Parameters

pos	The character position.
c	The character.

Returns: The filtered character which corresponds to character c at position pos.

§ FindMask()

static IliInputMaskIpl* IliInputMaskIpl::FindMask ( const char * definition )

static

Returns a pointer to the mask that corresponds to the definition.

Parameters

definition The definition or an alias.

Returns: A pointer to the mask that corresponds to the definition. If the mask cannot be found, it returns null.

§ format()

virtual IlBoolean IliInputMaskIpl::format	(	IliString &	dest,
		const IliValue &	src,
		IlBoolean	forEdit
	)		const

virtual

Uses the mask to format a value.

Parameters

dest	The formatted string.
src	The value.
forEdit	If `IlTrue`, the mask is used to enter data, otherwise the mask is used for display.

§ formatForClipboard()

virtual void IliInputMaskIpl::formatForClipboard	(	IliString &	dest,
		const char *	src,
		IlInt	startPos
	)		const

virtual

Formats a value for the clipboard.

Parameters

dest	The formatted string.
src	The value.
startPos	The position of the first character that is selected.

§ getEffectiveDefinition()

virtual const char* IliInputMaskIpl::getEffectiveDefinition ( ) const

protectedvirtual

Returns the effective definition of the mask.

An effective definition is a string of characters.

Returns: The definition.

§ getFirstEditablePos()

IlInt IliInputMaskIpl::getFirstEditablePos ( ) const

Returns the position of the first character that can be edited.

Returns: The position.

§ getLastEditablePos()

IlInt IliInputMaskIpl::getLastEditablePos ( ) const

Returns the position of the last character that can be edited.

Returns: The position.

§ getMaxCharMask()

IlInt IliInputMaskIpl::getMaxCharMask ( ) const

Returns the maximum length of the mask.

Returns: The maximum.

§ getMaxEntryChar()

virtual IlInt IliInputMaskIpl::getMaxEntryChar ( ) const

virtual

Returns the maximum number of characters that can be entered.

Returns: The maximum.

§ getNextEditablePos()

virtual IlInt IliInputMaskIpl::getNextEditablePos ( IlInt pos ) const

virtual

Returns the position of the next character that can be edited.

Parameters

pos	The current position.

Returns: The position.

§ GetNullMask()

static IliInputMaskIpl* IliInputMaskIpl::GetNullMask ( )

static

Returns a pointer to the null mask.

Returns: The null mask.

§ getPreviousEditablePos()

virtual IlInt IliInputMaskIpl::getPreviousEditablePos ( IlInt pos ) const

virtual

Returns the position of the previous character that can be edited.

Parameters

pos	The current position.

Returns: The position.

§ getValueFormat()

virtual const IliFormat& IliInputMaskIpl::getValueFormat ( ) const

protectedvirtual

Returns the format used to format the value (from the database) into a string.

Returns: The format.

§ isConstantChar()

virtual IlBoolean IliInputMaskIpl::isConstantChar ( IlInt pos ) const

virtual

Returns IlTrue if a character is Constant.

Parameters

pos	The character position.

Returns: IlTrue if the character at the position pos is Constant, otherwise returns IlFalse.

§ isFixChar()

virtual IlBoolean IliInputMaskIpl::isFixChar ( IlInt pos ) const

virtual

Returns IlTrue if a character is Fix.

Parameters

pos	The character position.

Returns: IlTrue if the character at the position pos is Fix, otherwise returns IlFalse.

§ isNeededChar()

virtual IlBoolean IliInputMaskIpl::isNeededChar ( IlInt pos ) const

virtual

Returns IlTrue if a character is Standard and Mandatory.

Parameters

pos	The character position.

Returns: IlTrue if the character at the position pos is Standard and Mandatory, otherwise returns IlFalse.

§ isValidChar()

virtual IlBoolean IliInputMaskIpl::isValidChar	(	IlInt	pos,
		wchar_t	c,
		IlBoolean	editMode
	)		const

virtual

Returns IlTrue if a character on the mask is valid.

Parameters

pos	The character position on the mask.
c	The character.
editMode	If `IlTrue`, the mask is used to enter data, otherwise the mask is used to display the valid characters.

Returns: IlTrue if the character is valid.

§ killChar()

virtual wchar_t IliInputMaskIpl::killChar	(	IlInt	pos,
		wchar_t	c
	)

virtual

Returns the character used to replace a deleted character.

Parameters

pos	The character position.
c	The character.

Returns: The character used to replace the deleted character c at position pos.

§ RemoveCustomMask()

static void IliInputMaskIpl::RemoveCustomMask ( IliInputMaskIpl * msk )

static

Removes a mask from the list of predefined masks.

Parameters

msk The mask.

§ setMaxCharMask()

void IliInputMaskIpl::setMaxCharMask ( IlInt v )

Sets the maximum length of the mask.

Parameters

v	The maximum length.

§ unFormat()

virtual IlBoolean IliInputMaskIpl::unFormat	(	IliString &	dest,
		const char *	src
	)		const

virtual

Unformats a string.

Parameters

dest	The unformatted string.
src	The string.

Public Member Functions

Static Public Member Functions

Protected Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

§ IliInputMaskIpl()

Member Function Documentation

§ AddCustomMask()

§ checkIndexChar()

§ filterChar()

§ FindMask()

§ format()

§ formatForClipboard()

§ getEffectiveDefinition()

§ getFirstEditablePos()

§ getLastEditablePos()

§ getMaxCharMask()

§ getMaxEntryChar()

§ getNextEditablePos()

§ GetNullMask()

§ getPreviousEditablePos()

§ getValueFormat()

§ isConstantChar()

§ isFixChar()

§ isNeededChar()

§ isValidChar()

§ killChar()

§ RemoveCustomMask()

§ setMaxCharMask()

§ unFormat()