The present invention relates to structured entry filter component of a user interface for a computer system.
A common requirement in a computer system user interface is entering information. This is typically done using entry fields. For text entry, typical characteristics of entry fields include a means for showing the insertion position, a means for moving the insertion position, and a means for entering text at the insertion position. Further characteristics may include the ability to select a section of the entered text, and operate on the selected text in a variety of ways.
There are certain constraints that can be enforced in order to get different types of data from the user. An example of this is ensuring the correct capitalisation of a title. Another example is the restriction of entry to numeric characters only.
Where complex data entry is required, such as with date or time values, it is helpful to consider the structure of the value. For example, a short UK date format may be considered as three distinct editable numeric elements with two non-editable separators between them. A common way of achieving this is to use a series of separate entry fields with each field forming one of the editable sections of the overall structure. This approach has several disadvantages. The user sees disjoint entry fields with fixed boundaries, rather than a single integrated entry field containing the required structure. Also, it is difficult to obtain the whole value with such a solution, as it is composed of many separate fields.
Accordingly, the present invention provides a set of components for facilitating user input in an application, said set of components comprising: an entry field component being instantiable to receive user input, to store said user input, to change status responsive to said user input, to generate one or more events indicative of said status and being adapted to allow instances of the entry field component to add one or more entry filter components as listeners to the or each event; one or more entry filter components being instantiable to respond to one or more of the or each events, instances of the or each entry filter being adapted to read said user input and to modify said user input according to one or more conditions associated with the or each entry filter component; a structured entry filter manager component being instantiable to receive a pattern dividing an instance of an entry field into a plurality of editable areas, at least one of said editable areas having an associated instance of entry filter, instances of said filter manager being adapted to add themselves as listeners to events generated by an entry field instance and to relay said events to any entry filter instances associated with an editable area of said entry field to which said event applies; and a structured entry filter component being instantiable to determine said pattern according to a required format and to pass said pattern to said structured entry filter manager.
In a further aspect the invention provides a structured entry filter manager component for facilitating user input in an application, said component being cooperable with an entry field component being instantiable to receive user input, to store said user input, to change status responsive to said user input, to generate one or more events indicative of said status and being adapted to allow instances of the entry field component to add one or more entry filter components as listeners to the or each event; and an entry filter component being instantiable to respond to one or more of the or each events, instances of the or each entry filter being adapted to read said user input and to modify said user input according to one or more conditions associated with the or each entry filter component; said structured entry filter manager component being instantiable to receive a pattern dividing an instance of an entry field into a plurality of editable areas, at least one of said editable areas having an associated instance of entry filter, instances of said filter manager being adapted to add themselves as listeners to events generated by an entry field instance and to relay said events to any entry filter instances associated with an editable area of said entry field to which said event applies.
The present invention provides a mechanism for constructing an entry filter which encapsulates a complex structure by allowing it to be considered as distinct editable elements with non-editable separators between them. Each such element can be treated as an entry field in its own right, and can have one or more entry filters associated with it to obtain the desired behaviour. In this way, the logic for applying simple constraints can be re-used and combined to achieve sophisticated results.
The invention enables an entry field to be split up into distinct editable elements, with different sets of rules for each element, while the end user perceives one integrated entry field. In the context of the present invention, an entry field is anything allowing input from a plurality of input devices, and doesn't necessarily have to be textual. However, the invention will be described in terms of a preferred embodiment which performs text filtering.
The embodiment includes a component that manages collections of editable elements of a complex structure. The editable element component adheres to an encapsulated definition of an entry field, and additionally defines a subset of the input area. The manager component adheres to an encapsulated definition of an entry filter, and acts as an interface between an entry field and an associated collection of editable elements.
The manager component responds to notifications of user input events from the associated entry field by determining the appropriate editable element to which the notification applies, and causing the editable element to issue the corresponding notification in its turn. The element manager also handles queries and modifications of characteristics of the editable elements by mapping them onto the associated entry field. The element manager also responds to changes to the content of the associated entry field by dynamically adjusting the subset of the input area defined by each editable element, and ensuring that any non-editable element separators are preserved, so as to maintain the required structure.
In this way, each editable element is able to represent a subset of the input area while adhering to the encapsulated definition of an entry field. Also, a collection of editable elements together with their associated element manager are able to represent a complex structure while adhering to the encapsulated definition of an entry filter. One important aspect of the resulting structured entry filter is that one or more entry filters can themselves be associated with the individual editable elements.
a) to (e) illustrate some entry fields operating with entry filters and structured entry filters according to the invention; and
The present invention according to a preferred embodiment is implemented as a software component for controlling the operation of a computer system on which it is run. The software component may be modified to run on many different types of computer and operating system platforms. The computer program code according to the preferred embodiment is written in the Java programming language (Java is a trademark of Sun Microsystems Inc.). As is known in the art, the Java language provides for the abstract definition of required behaviours by a construct known as an interface. Concrete implementation of these behaviours can then be provided by classes which implement these interfaces.
In general terms, entry fields expose methods which allow their text to be queried, set and modified, for example, getText, setText, append, insert. Entry fields also generate events, for example, keyPressed/or textValueCompleted. (In the present embodiment, these events are in fact method calls issued by the entry field to listeners which the entry field knows implement such methods.) Entry filters operate with entry fields which allow for the addition of listeners which implement methods for one or more entry field events and, according to the constraints they apply to the text entered in the entry field, the filters determine the final value of the entry field. It is possible to associate one or more entry filters with an entry field, so that the desired composite behaviour can be obtained.
Examples of such filters are an AutoCompleteTextFilter, NumericTextFilter and TitleTextFilter. The functionality of these filters is well known and computer users will be used to filling in entry fields having such functionality in on-screen forms. However, this functionality is commonly implemented as an integral part of an entry field, rather than as a plug-in behaviour as in the case of the present invention. This plug-in behaviour not only enables the same entry field implementation to be used for many individual types of behaviour, but also allows more than one entry filter to be applied to a field to generate complex behaviour. For example, an AutoCompleteTextFilter and a TitleTextFilter can be applied to an entry field so that when a candidate is automatically returned by the AutoComplete filter to complete the field, it is then capitalised in a manner determined by the TitleTextFilter.
Referring now to
TextEditable
An encapsulated definition of the services expected of a text entry field is embodied in a TextEditable interface. Each characteristic required of a text entry field is thus supported by one or more methods defined by this interface. As is known in the art, the Java Abstract windowing Toolkit (AWT) includes an entry field component within the java.awt.TextComponent class. Many of the methods defined by the TextEditable interface are also found on the java.awt.TextComponent class. A concrete implementation of the TextEditable interface is implemented within the TextComponentEditable class which is a simple wrapper for java.awt.TextComponent. A separate implementation TextElementEditable,
The TextEditable interface defines the following methods which, unless otherwise noted, correspond to the methods implemented by java.awt.TextComponent:
getCaretPosition and setCaretPosition allow the text insertion position to be queried and modified.
getSelectionStart, setSelectionStart, getSelectionEnd and setSelectionEnd allow the start and end positions of the currently selected text to be queried and modified individually.
select allows the start and end positions of the currently selected text to be modified together.
selectAll selects the entire text.
getText and setText allow the current text to be queried and modified.
append, insert and replaceRange allow the current text to be manipulated in various ways.
transferFocus allows user input focus to be transferred to the next available component.
getValid and setValid, not in TextComponent, control whether the current text is to be shown as valid according to any associated constraints.
addTextEditableListener and removeTextEditableListener, not in TextComponent, allow the addition and removal of filters which are listeners for TextEditable events. Such filters must implement a TextEditableListener interface, described below, which describes the events which may be generated by implementations of TextEditable.
TextEditableListener
This interface describes the events which may be generated by implementations of TextEditable. It defines the following methods:
keyPressed/, keyReleased and keyTyped allow keyboard events to be intercepted and any necessary actions to be taken. Using the methods on the TextEditableEvent class, described below, the details of the event may be modified, or the event suppressed.
caretPositionChanged is called when the text insertion point's position changes.
textValueChanged is called when the value in the text field changes.
textValueCompleted is called when the user has indicated that data entry is complete.
focusGained and focusLost are called when the text field gains or loses user input focus.
TextEditableEvent
An instance of TextEditableEvent is delivered to each of the methods on TextEditableListener. It provides information about the event, and a means of modifying or suppressing certain of those events. It defines the following methods:
getTextEditable returns a reference to the instance of TextEditable that generated the event.
consume allows the event to be suppressed. Subsequent listeners will still receive the event but can determine that it has been suppressed.
isConsumed returns whether or not the event has been suppressed.
getModifiers and setModifiers allow modifiers to be queried and modified. For keyboard events, these modifiers indicate which of the keyboard augmentation keys was active when the event was generated, as defined in the java.awt.event.KeyEvent class.
getKeyCode and setKeyCode allow key codes to be queried and modified. For keyboard events, these key codes indicate exactly which key generated the event, as defined in the java.awt.event.KeyEvent class.
getKeyChar and setKeyChar allow key characters to be queried and modified. For keyboard events, these key characters indicate which character, if any, corresponds to the key which generated the event.
isTemporary allows the focus transfer state to be queried, to determine whether it has permanently or temporarily transferred. Temporary focus loss occurs when the window that contains the text field loses focus.
TextFilter
An encapsulated definition of the services provided by a text entry filter is embodied in the TextFilter interface. Each characteristic of a text entry filter is thus supported by one or more methods defined by this interface. TitleTextFilter, AutoCompleteTextFilter and NumericTextFilter are concrete implementations of the TextFilter interface.
The TextFilter interface defines the following methods:
setTextEditable allows the text filter to be associated with a single implementation of TextEditable. One or more text filters may be associated with a single implementation of TextEditable, although when more than one text filter is associated with a TextEditable it is important to ensure that the sets of constraints do not adversely interfere with each other.
getTextEditable returns a reference to the currently associated implementation of TextEditable.
getLocale and setLocale allow the java.util.Locale currently used by the text filter to be queried and modified. Implementations of the TextFilter interface can use this java.util.Locale to assist with the provision of internationalisation support.
getValue and setValue allow the text in the associated TextEditable to be queried and modified using a Java class that is appropriate to the function of the text filter.
getSample returns a sample of valid entry for this text filter. This embodiment is able to use this to provide user assistance for data entry.
getExitCharacters and setExitCharacters allow the characters which will trigger focus transfer out of the associated TextEditable to be queried and modified.
getRemoveSelectionOnFocusLost, setRemoveSelectionOnFocusLost, getSelectAllOnFocusGained and setSelectAllOnFocusGained allow the focus behaviour of the filter to be queried and modified.
addTextFilterListener, removeTextFilterListener, addTextFilterInputListener and removeTextFilterInputListener,
Thus, in a preferred embodiment,
TextComponentEditable
This class is an example of a concrete implementation of the TextEditable interface. It enables a java.awt.TextComponent to be used with the other classes in this embodiment. It primarily maps the methods defined by TextEditable to the equivalent methods on the java.awt.TextComponent class.
getValid and setValid have no equivalent on the java.awt.TextComponent class, and so are implemented by storing a Boolean data member.
TextComponentEditable, via the java.awt.TextComponent it encapsulates, listens to user generated events and as such acts as a key listener, a focus listener, and a text listener, in order that it can in turn issue the required TextEditable events, at the appropriate times. It is also a mouse listener, in order that it can monitor the caret position of the java.awt.TextComponent and issue the required caretPositionChanged events at the appropriate times. The textValueCompleted event is issued whenever the enter key is pressed or the java.awt.TextComponent loses user input focus.
In use, an application instantiates a TextComponentEditable and calls the setTextEditable method on each of the previously instantiated filters. setTextEditable in turn calls addTextEditableListener on the TextComponentEditable to add the appropriate filter, for example TitleTextFilter, to the entry field. The filters then listen to any subsequent events and apply the appropriate constraints to the text that may have been entered.
Filters such as NumericTextFilter will be inclined to wait until the textValueCompleted event before deciding whether a value entered is valid or needs modification, as such their implementation of events such as keyPressed/, keyReleased or keyTyped will be minimal. AutoCompleteTextFilter on the other hand listens for every character entered to determine if there is a match in its list of candidates for the text entered.
TextFilterListener
This interface describes the events which may be generated by implementations of TextFilter. It defines the following method:
textValueValidated is called whenever the text filter has attempted to establish whether or not the current text in the associated TextEditable is valid. This normally occurs when the associated TextEditable indicates that data entry is complete by issuing the textValueCompleted event.
TextFilterEvent
An instance of TextFilterEvent is delivered to the method on TextFilterListener. It provides information about the event. It defines the following methods:
getTextFilter returns a reference to the instance of TextFilter that generated the event.
getID returns the unique identifier of the event.
getText returns the text which was in the associated TextEditable when the event was generated.
isValid returns whether or not the text in the associated TextEditable was found to be valid when the event was generated.
getNumberOfFailures returns the number of consecutive validation failures since the last successful validation.
TextFilterInputListener
A more detailed interface than TextFilterListener, this interface describes further events which may be generated by implementations of TextFilter. It defines the following methods:
inputAccepted is called when text entry has conformed to the constraints imposed by the text filter.
inputRejected is called when text entry has not conformed to the constraints imposed by the text filter.
inputFormatted is called when text entry is successfully modified to conform to a format required by the text filter.
inputExtended is called when the text entry is automatically added to by the text filter.
TextFilterInputEvent
Similar to TextFilterEvent, an instance of TextFilterInputEvent is delivered to each of the methods on TextFilterInputListener, and provides information about the event. It defines the following methods:
getTextFilter returns a reference to the instance of TextFilter that generated the event.
getID returns the unique identifier of the event.
getText returns the text which was placed into the associated TextEditable as the event was generated.
getPreviousText returns the text which was in the associated TextEditable before the event was generated. For inputFormatted and inputExtended events, the value returned will be different from that returned by getText.
getNumberOfFailures returns the number of input rejections since the last input that was accepted.
It will be seen that the invention could also be implemented with a single class combining TextFilterEvent and TextFilterInputEvent and/or another class combining TextFilterListener and TextFilterInputListener, although it is felt that developers employing the invention may prefer the added granularity provided by separate classes.
TitleTextFilter
This class is an example of a concrete implementation of the TextFilter interface, an example of which is shown on the right of
The purpose of TitleTextFilter is to ensure that text entered conforms to one of a set of defined capitalization schemes. In order to be able to intercept events from the associated TextEditable, it also implements the TextEditableListener interface.
TitletextFilter provides the following additional methods:
getCaseOption and setCaseOption allow the capitalization scheme that is to be used by the filter to be queried and modified.
TitleTextFilter implements the methods of the TextFilter interface as follows:
setTextEditable adds the TitleTextFilter as a TextEditableListener to the supplied TextEditable, in order that the TextEditable events relevant to text capitalization are received. A reference to the supplied TextEditable is stored.
getTextEditable returns a reference to the currently associated TextEditable.
setLocale stores a reference to the supplied java.util.Locale. Locale services are used to perform text capitalization in the textValueChanged method described below.
getLocale returns a reference to the stored java.util.Locale.
getValue and setValue allow the current value to be queried and modified using the java.lang.String class. They are mapped directly to the getText and setText methods on the associated TextEditable.
getSample uses the currently selected capitalization scheme to return a sample of valid entry for this text filter.
setExitCharacters stores the supplied array of characters. These characters are used to trigger focus transfer in the keyPressed/method described below.
getExitCharacters returns the stored array of exit characters.
setRemoveSelectionOnFocusLost and setSelectAllOnFocusGained store the supplied Boolean values. These values are used in the focusLost and focusGained methods described below.
getRemoveSelectionOnFocusLost and getSelectAllOnFocusGained return the stored Boolean values.
addTextFilterListener and addTextFilterInputListener add the supplied listener to the appropriate collection of listeners. These collections of listeners are used to issue appropriate events in the textValueChanged, textValueCompleted, and keyTyped methods described below.
removeTextFilterListener and removeTextFilterInputListener remove the supplied listener from the appropriate collection of listeners.
TitleTextFilter implements the methods of the TextEditableListener interface as follows:
keyPressed matches the key character that generated the event against the stored array of exit characters. If a match is found then focus is transferred by calling the transferFocus method on the associated TextEditable.
keyTyped uses the services provided by the stored java.util.Locale to determine whether the key character that generated the event is the first character of a new word. This information, in conjunction with the current capitalization scheme, is used to determine the correct case for the character. If the correct case differs from that of the key character, the key character is modified by using the setKeyChar method on the supplied TextEditableEvent, and an inputFormatted event is issued to the collection of TextFilterInputListeners. Finally, an inputAccepted event is issued to the collection of TextFilterInputListeners.
textValueChanged uses the services provided by the stored java.util.Locale to correctly capitalise the current text in the associated TextEditable using the current capitalization scheme, and an inputFormatted event is issued to the collection of TextFilterInputListeners.
textValueCompleted issues a textValueValidated event to the collection of TextFilterListeners.
focusGained uses the stored Boolean value set by setSelectAllOnFocusGained to determine whether the text in the associated TextEditable is to be selected. If it is, the selectAll method on the associated TextEditable is called.
focusLost uses the stored Boolean value set by setRemoveSelectionOnFocusLost to determine whether the text in the associated TextEditable is to be de-selected. If it is, the select method on the associated TextEditable is called in such a way as to remove the current selection without moving the text insertion point.
keyReleased and caretPositionChanged have empty implementations, as these events are not relevant to text capitalization.
It will be seen that the implementation of TitleTextFilter does not affect the content of the information in the entry field, only its format. Other implementations of TextEditableListener, AutoCompleteTextFilter and NumericTextFilter shown in
AutoCompleteTextFilter, uses a supplied list of expected values to provide prompted entry. It may also be provided with a list of separators to enable the user to insert a list of entries in a single entry field. In the case of
AutoCompleteTextFilter also provides the method setCompletionDelay, which allows other objects to specify the time in milliseconds after the last user input before auto-completion is applied.
NumericTextFilter on the other hand needs to be provided with minimum and maximum valid values, minimum and maximum lengths of numbers as well as formatting parameters. Unlike the other two filters NumericTextFilter does not need to expose any additional methods to other objects to allow it to be configured appropriately.
Still further variations of text filters are also possible. For example a check digit validation and/or generation filter could be generated for attachment to an entry field. Use of check digits is becoming more and more common to allow for validation of relatively long serial or application numbers. The check digit is usually calculated as a function of the individual digits of the serial number and added to the end of the number, sometimes after a full stop. For example, a UK patent application root number “9816476” is given a check digit “7” and the complete number is usually written “9816476.7”. A check digit filter would need to have a number of properties. If it were not generic, then a grammar defining the function for calculating the check digit would need to be specified in a suitable manner. A property determining whether the filter would simply validate and entered check digit or whether it would complete a root number could also be made available, so that if a user stopped typing at the end of the root number or the full stop, the check digit would be calculated and inserted. In this case the input would always be valid. As with the AutoCompleteTextFilter a setCompletionDelay method would also need to be exposed. It will be seen that it would be possible to combine such a filter with an AutoCompleteTextFilter so that a syntactically correct number could be checked against a database for semantic correctness, for example, to check if an application of that number has been filed.
According to the present invention, entry filters, described above, work with a sub-set of an editable area managed by a structured text filter,
TextElementEditable
TextElementEditable is a concrete implementation of the TextEditable interface. It is used in conjunction with StructuredTextFilter, described below, and represents an editable element in a complex structure. Instances of TextElementEditable are constructed by a factory method on StructuredTextFilter, and remain permanently linked to a single instance of StructuredTextFilter.
TextElementEditable stores the start position and the end position of the subset of the editable area which the element represents. It also stores the current text for this element, and a reference to the StructuredTextFilter to which it is linked.
This class implements the methods of the TextEditable interface as follows:
addTextEditableListener adds the supplied listener to the collection of listeners. This collection of listeners is used to issue appropriate events in the methods described below.
removeTextEditableListener removes the supplied listener from the collection of listeners.
setText updates the stored text for this element, and then calls an updateElement method on StructuredTextFilter, described below. It then issues a textValueChanged event to the collection of TextEditableListeners.
append, insert and replaceRange manipulate the current text in various ways, and call the setText method with the result.
getCaretPosition, setCaretPosition, getSelectionStart, setSelectionStart, getSelectionEnd, setSelectionEnd and select call the corresponding methods on the TextEditable associated with the StructuredTextFilter, adjusting the parameters and return values by using the stored start and end positions.
selectAll calls the corresponding method on the TextEditable associated with the StructuredTextFilter.
transferFocus attempts to locate the next element in the collection of active elements for the StructuredTextFilter and set the text insertion point position of the associated TextEditable to the start position of that element, thus transferring focus to the next available element. If no next element is found, the transferFocus method on the associated TextEditable is called, thus transferring focus to the next available component.
StructuredTextFilter
This class is a concrete implementation of the TextFilter interface. It is used in conjunction with one or more TextElementEditables to provide a structured text entry mechanism according to the invention. In order to be able to intercept events from the associated TextEditable, it also implements the TextEditableListener interface.
This class provides the following additional methods:
createTextElementEditable returns a new instance of TextElementEditable linked to the StructuredTextFilter.
setStructure defines the structure of editable and non-editable elements that will be managed by the StructuredTextFilter. This method accepts a text string to be used as the non-editable prefix, an array of TextElementEditables that will act as the editable elements of the structure, and an array of text strings to be used as the non-editable suffixes which follow each editable element. The length of the prefix, the length of the current text for each element, and the length of each suffix are used to compute the start position and the end position stored by each element.
elementAt returns the TextElementEditable which contains the supplied position. A TextElementEditable contains all positions from its own start position to the start position of the next TextElementEditable.
setFocusElement sets the text insertion point position of the associated TextEditable to the start position of the supplied TextElementEditable.
getFocusElement returns the TextElementEditable which contains the text insertion point of the associated TextEditable, or null if the text insertion point is within the non-editable prefix area.
updateElement uses the current text for the supplied TextElementEditable to re-compute the stored end position of the element, and also the stored start position and end position for each subsequent element. It then applies the element text to the associated TextEditable by calling its replaceRange method.
This class implements the methods of the TextFilter interface as follows:
setTextEditable adds the StructuredTextFilter as a TextEditableListener to the supplied TextEditable, in order that the TextEditable events relevant to structured text entry are received. A reference to the supplied TextEditable is stored.
getTextEditable returns a reference to the currently associated TextEditable.
setLocale stores a reference to the supplied java.util.Locale.
getLocale returns a reference to the stored java.util.Locale.
getValue and setValue allow the current value to be queried and modified using the java.lang.String class. They are mapped directly to the getText and setText methods on the associated TextEditable, in the expectation that this method will be overridden by classes extending StructuredTextFilter.
getSample returns an empty string in the expectation that this method will be overridden by classes extending StructuredTextFilter.
setExitCharacters stores the supplied array of characters. These characters are used to trigger focus transfer in the keyPressed method described below.
getExitCharacters returns the stored array of exit characters.
setRemoveSelectionOnFocusLost and setSelectAllOnFocusGained store the supplied Boolean values. These values are used in the focusLost and focusGained methods described below.
getRemoveSelectionOnFocusLost and getSelectAllOnFocusGained return the stored Boolean values.
addTextFilterListener and addTextFilterInputListener add the supplied listener to the appropriate collection of listeners. These collections of listeners are used to issue appropriate events in the textValueChanged, textValueCompleted and keyTyped methods described below.
removeTextFilterListener and removeTextFilterInputListener remove the supplied listener from the appropriate collection of listeners.
StructuredTextFilter implements the methods of the TextEditableListener interface as follows:
keyPressed/matches the key character that generated the event against the stored array of exit characters. If a match is found then focus is transferred by calling the transferFocus method on the associated TextEditable. If no match is found, this method causes the TextElementEditable returned by the getFocusElement method to issue a keyPressed/event to its collection of TextEditableListeners.
keyTyped and keyReleased cause the TextElementEditable returned by the getFocusElement method to issue a keyTyped or keyReleased event to its collection of TextEditableListeners.
textValueChanged parses the new text in the associated TextEditable, using the prefix and the suffixes as delimiters, to obtain the new text for each editable element. If the prefix or any of the suffixes does not appear fully in the new text, then they are restored by building the complete value using the prefix, the suffixes and the current text for each editable element, and applying that complete value to the associated TextEditable by calling the setText method. In this way the preservation of the non-editable prefix and all of the non-editable suffixes is ensured.
textValueCompleted issues a textValueValidated event to the collection of TextFilterListeners.
focusGained uses the stored Boolean value set by setSelectAllOnFocusGained to determine whether the text in the associated TextEditable is to be selected. If it is, the selectAll method on the associated TextEditable is called. If not, the setFocusElement method is called supplying the first TextElementEditable as the parameter.
focusLost uses the stored Boolean value set by setRemoveSelectionOnFocusLost to determine whether the text in the associated TextEditable is to be de-selected. If it is, the select method on the associated TextEditable is called in such a way as to remove the current selection without moving the text insertion point. Finally, it causes the TextElementEditable returned by the getFocusElement method to issue a focusLost event to its collection of TextEditableListeners.
caretPositionChanged determines whether the new text insertion point is contained within a different TextElementEditable to that which contains the previous text insertion point. If so, it causes the TextElementEditable which contains the previous text insertion point to issue a focusLost event to its collection of TextEditableListeners, and then causes the TextElementEditable which contains the new text insertion point to issue a focusGained event to its collection of TextEditableListeners.
DateFilter
This class is an example of an extension to the StructuredTextFilter class. Its purpose is to create and maintain a structure of editable elements and non-editable areas which together form a filter for date and/or time entry. An example is shown in
NumericTextFilter, as described above, restricts input to numeric characters, and can also be configured with range and formatting information. It is used for numeric elements of the date format, such as day number, month number, year, hour, minute, and second.
AutoCompleteTextFilter is used for elements of the date format which have a small set of possible values, such as day name, month name, era, and time zone.
The structure for a DateFilter is specified by a pattern composed of masking characters as defined by the java.text.SimpleDateFormat class. Alternatively, the structure can be specified using one of the predefined formats defined by the java.text.DateFormat class. In this case, Locale services are used to convert each of these predefined formats to a pattern.
The pattern is used to determine the non-editable prefix, the requisite number of TextElementEditables, the appropriate text filters to be associated with each TextElementEditable, and the non-editable suffixes. Each required TextElementEditable is created using the createTextElementEditable method, and the appropriate text filters are then created and associated with it. The prefix, the TextElementEditables and the suffixes are then supplied to the setStructure method of StructuredTextFilter.
DateFilter also provides the following additional methods:
setDateUsed and setTimeUsed store the supplied Boolean values. These values control the inclusion of the date and time parts of the structure.
getDateUsed and getTimeUsed return the stored Boolean values.
setDateFormatStyle and setTimeFormatStyle store the supplied predefined formats defined by java.text.DateFormat. These values control the format of the date and time parts of the structure.
getDateFormatStyle and getTimeFormatStyle return the stored predefined formats.
setPattern allows a custom pattern to be specified.
getPattern returns the current pattern.
DateFilter also overrides the following methods of StructuredTextFilter:
setLocale stores a reference to the supplied java.util.Locale. Locale services are used to apply the correct formatting characteristics. Changing the Locale may cause the entire structure to be recreated.
getLocale returns a reference to the stored java.util.Locale.
setValue allows the current value to be modified using the java.util.Date class. Locale services are used to convert the supplied java.util.Date value to a java.lang.String value, which is passed to the setText method on the associated TextEditable.
getValue uses Locale services to return a java.util.Date object representing the current value.
getSample uses Locale services to return a java.lang.String representing the current date formatted according to the current pattern.
When an event, for example a key press, occurs, TextComponentEditable issues the keyPressed/event to its listeners. One of these listeners is the instance of StructuredTextFilter. StructuredTextFilter then needs to determine which of the TextElementEditables has user input in focus which it does by calling getFocusElement.
StructuredTextFilter then causes the TextElementEditable returned to issue a keyPressed/event to each of its listeners. This is made possible because each TextElementEditable also implements a list of methods corresponding to the events it can generate. For example, a method fireKeyPressed is available to enable objects to cause a TextElementEditable to call keyPressed on each of its listeners. These listeners are the appropriate text filters for the element.
Depending on the event and the text filter, the text filter may need to change the contents of the entry field. It does this by calling setText on its associated TextEditable—this will be the appropriate TextElementEditable. The TextElementEditable in turn calls updateElement on the StructuredTextFilter. updateElement then calls replaceRange on the associated TextEditable to substitute the value for the old value. The associated TextEditable will be the TextComponentEditable with which the user is interacting. updateElement then adjusts the start and end positions for each TextElementEditable before finishing.
The instance of DateFilter can determine the value of the entire entry field at any time by calling getValue on StructuredTextFilter which is in turn mapped onto getText on the associated TextEditable, which is the TextComponentEditable.
A further example of a structured text filter, DecimalFilter, is shown in
All decimal number formats provided by Java Development Kit 1.1 internationalisation can be supported. The required format may be specified, or the locale default used.
Since these formats vary from country to country, the expected format is determined by the default or specified locale. DecimalFilter determines the type and order of the elements, as well as the appropriate element prefix and suffixes. Numeric text filters are applied to the elements representing the integer and fraction parts of the number. An appropriate prefix and/or suffixes are set to represent the currency symbol(s), percent symbol(s), decimal separator(s), and negative symbol(s). Locale services are used to obtain these symbols, and their correct positions.
For example, -123.45 as a currency in a US English locale would look like this: ($123.45). This can be considered as two elements: the first element uses a numeric text filter, and has a suffix set to the decimal separator for the locale; the second element uses a numeric text filter constrained to two digits, and has a suffix of “)”. The “(” and the currency symbol are combined to form the prefix.
It will be seen that, while the present embodiment is described in terms of Java, the invention is applicable to components written in other languages. For example, the components could also be written as a set of ActiveX Controls possibly for use by a visual builder such as Microsoft Visual Studio '97. Such controls can be used to build an application in a similar manner to that for Java without departing from the scope of the invention.
It should also be noted that for simplicity and clarity, the description has in many places described the operation of the invention in terms of the names of classes themselves. It will of course be apparent to those skilled in the art, that it is in fact instances of these classes that operate at run-time, with those instances in general being given different names to those of the classes of which they are instances. This convention should not, however, detract from the overall level of the disclosure.
Number | Date | Country | Kind |
---|---|---|---|
9816476.7 | Jul 1998 | GB | national |
Number | Name | Date | Kind |
---|---|---|---|
5247611 | Norden-Paul et al. | Sep 1993 | A |
5845300 | Comer et al. | Dec 1998 | A |
5900004 | Gipson | May 1999 | A |
5999937 | Ellard | Dec 1999 | A |
6052693 | Smith et al. | Apr 2000 | A |
6085206 | Domini et al. | Jul 2000 | A |
6167523 | Strong | Dec 2000 | A |
6208339 | Atlas et al. | Mar 2001 | B1 |
6367068 | Vaidyanathan et al. | Apr 2002 | B1 |
Number | Date | Country |
---|---|---|
435 478 | Jul 1991 | EP |