Element Meaning
c A character represents itself unless it has a special regexp meaning. e.g. c matches the character c.
\c A character that follows a backslash matches the character itself, except as specified below. e.g., To match a literal caret at the beginning of a string, write \^.
\a Matches the ASCII bell (BEL, 0x07).
\f Matches the ASCII form feed (FF, 0x0C).
\n Matches the ASCII line feed (LF, 0x0A, Unix newline).
\r Matches the ASCII carriage return (CR, 0x0D).
\t Matches the ASCII horizontal tab (HT, 0x09).
\v Matches the ASCII vertical tab (VT, 0x0B).
\xhhhh Matches the Unicode character corresponding to the hexadecimal number hhhh (between 0x0000 and 0xFFFF).
\0ooo (i.e., \zero ooo)
matches the ASCII/Latin1 character for the octal number ooo (between 0 and 0377).
. (dot) Matches any character (including newline).
\d Matches a digit (QChar::isDigit()).
\D Matches a non-digit.
\s Matches a whitespace character (QChar::isSpace()).
\S Matches a non-whitespace character.
\w Matches a word character (QChar::isLetterOrNumber(), QChar::isMark(), or '_').
\W Matches a non-word character.
\n The n-th backreference, e.g. \1, \2, etc.
Text Box - The multiline text box is used only if more than one line of input is required and allows you to input text information. To input a new line the user must press CTRL+Enter. By pressing only the Enter key will close the text box.
Columns - Define the number of columns of you text box (max: 128)
Rows - Define the number of rows of you text box (max: 128)
Value - Defines the object as a numeric value.
Minimum Value - Defines the minimum value reachable, normally used to countdown.
Maximum Value - Defines the maximum value.
Step Value - Define step value when updated, use negative value for countdown.
Decimals - Defines the number of decimal places.
Alignment - Set horizontal alignment
Prefix - Defines character set that precedes the number.
Suffix - Defines character set shown after the number.
Special Value - Is the value the object will assume after reaching the maximum or minimum values.
Integer Value - Allows you to write any integer value in one line box.
Maximum Value - Defines the maximum value.
Step Value - Define step value when updated, use negative value for countdown.
Alignment - Set horizontal alignment
Prefix - Defines character set that precedes the number.
Suffix - Defines character set shown after the number.
Special Value - Is the value the object will assume after reaching the maximum or minimum values.
Chapter 4. Design 97
Minimum Date - Set the minimum value to date to avoids backdating.
Maximum Date - Set the maximum value to date to avoids introducing later dates.
Alignment - Allows you to align text date inside object.
Calendar Pop-up - Every time you change settings on date field it pops up a calendar to easy date manipulation.
Date Format - Helps you set a date value format, you have some predefined.
Time - Allows you to write any time value in one line box.
Minimum Time - Set the minimum value to time to avoids backtiming
Maximum Time - Set the maximum value to date to avoids introducing later time.
Alignment - Allows you to align time text inside object.
Time Format - Helps you set a time value format, you have some predefined.
Date and Time - Allows you to write any date and time value in one line box.
Minimum Date - Set the minimum value to date to avoids backdating.
Maximum Date - Set the maximum value to date to avoids introducing later dates.
Minimum Time - Set the minimum value to time to avoids backtiming
Maximum Time - Set the maximum value to date to avoids introducing later time.
Alignment - Allows you to align text date inside object.
Calendar Pop-up - Every time you change settings on date field it pops up a calendar to easy date manipulation.
Date and Time Format - Helps you set a date and time value format, you have some predefined.
List - Allows you to create a list, composed by two columns, the first is an index column and the second is the data column.
Chapter 4. Design 99
Database List - Allows you to create a combobox to select the update data to your object. This only works if connected to a SQL database.
The SQL Select statement is part of the SQL code and bellow we describe some examples in how to use that code, specially how to use the select statement.
SELECT column_name(s) FROM table_name
extension and salary fields, from the employee database. This is the first step, the second is to set a condition, only consider the records with the field salary with a value lower than 35000.
Now the selection is made and the condition is set.
User Column - Here you define what column will be listed on the combo box, as a reference to the Data Column.
Data Column - Define to wish column belong the data that will be shown on the database list object.
Limit Rows - Setup the maximum rows to be listed on the combo box, to a maximum of 99.
After we define the User Column as 0 and the Data Column as 1, we define the column to be listed as the first (the count starts from zero) and the Data Column as the second and the result will be as shown bellow.
Chapter 4. Design 101
On your combo box is only listed the position field records (User Column 0) that matches the condition (salary<35000). And when the position Mail Clerk is selected the object assume the extension field record of the selected position 6261.
Font Auto Adjust - Automatically adjust the font size, but only if font point size is auto.
Concatenation - Allows you to add a prefix or a suffix to your date and it can be printable, to do that just check on the check-box.
4.4.10.1.4 4.4.10.1.4 - Database
There are two ways to add an object linked to a database to the card document. Open a database and drag and drop the fields like explained further on this manual or create the object and then connect it to a database. We will address the last option now.
After creating an object go to the Source Tab and select the Database option.
After you have chosen this option your tab changes.
And the next step is to click on the button 'Connect to a Database'. The Database Connection Wizard will start allowing you to connect to any database you want.
After the database is opened, by default the object will be connected to the first table and first column of your database, like shown on picture bellow. All you have to do now is define the table and column that you want your object to be linked to.
Font Auto Adjust - When you have defined a size for your object it allows you to choose if you want cardPresso to automatically adjust the font size.
Chapter 4. Design 103
Concatenation - Allows you to add a prefix or a suffix to your data and print it. While in datatabase mode you can concatenate up to four columns on the same object and define a prefix separator if needed.
As you can see the first element on our object is 'Employee ID' the one connected by default and the two others we choose to merge in our object, the first and last names.
Chapter 4. Design 105
4.4.10.1.5 4.4.10.1.5 - Item Link
This option allows you to connect an object to another, assuming the same values with automatic update.
When you chose this option your tab changes, allowing you to chose an object to link, showing on the list all objects that are on the card space and which is possible to connect, in this particular case we have a card with three other objects.
When connected the object will assume the linked object value and every time it is updated so is our object.