Frequently asked questions - Base

From The Document Foundation Wiki
< Faq‎ | Base
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎français • ‎italiano • ‎čeština

How can I format a field as uppercase/lowercase?

This is how to make the entry of a field "Name" all uppercase and make only the first letter of the field "Firstname" uppercase.

There are two different solutions: using a masked field or a macro.

Whichever solution is chosen, it is useful to define the relevant fields in the table holding the data with the format "Text [VARCHAR_IGNORECASE]". The searches or selections from queries will be easier because they will be case insensitive.

Using a field mask

In the entry form, choose the "Masked field" control. This control is an entry field, which has two particular properties relevant to this task.

Entry mask Put the character codes, not the data to be entered: one code = one character[1]

The codes determine what the field will accept at that position.

Field validation Yes: Only the characters specified as valid will be accepted

No: Invalid characters will be removed on leaving the field

To convert the field "Name" to uppercase automatically use the code "X":

  • All characters are allowed (this is not limited to letters because it is possible to enter hyphens or apostrophes
  • Automatic conversion from lowercase to uppercase
  • The permitted number of characters is indicated by the number of the X characters
  • Field validation: Yes

To capitalise just the first letter of the field "Firstname", use the code "A" followed by "x":

  • The code "A" allows only the capital letters A-Z to be entered (hyphens and apostrophes aren't allowed at the beginning of a name): if a lowercase letter is entered it is automatically converted to uppercase.
  • With "x" all characters are allowed.

Using a macro

It is possible to associate a macro with the event "Before update" of text fields. This event is triggered before the content of the changed control is written to the database.

We can change everything that has been entered with the uppercase/lowercase conversion.

Below is the code for two Python procedures "PysCapitaliseAll" and "PysCapitaliseOne" which are associated with the entry fields "Name" and "Firstname" respectively.

The procedures take as a parameter the contents of the control in question. They change the text contained in the text field.

  • PysCapitaliseAll changes everything to uppercase.
  • PysCapitaliseOne changes only the first character to uppercase.

option explicit

sub PysCapitaliseOne(PysEvent)
PysEvent.Source.text = Ucase(left(PysEvent.Source.text, 1)) & Lcase(mid(PysEvent.Source.text, 2))
end sub

sub PysCapitaliseAll(PysEvent)
PysEvent.Source.text = Ucase(PysEvent.Source.text)
end sub