Active
|
Controls if this row is active for use. Uncheck this if you temporarily wants to disable an item.
|
ItemUid (Mandatory)
|
In order to place an item on a window, it must have a unique id for the form. In order to avoid conflict with other add-ons, this should have prefix (e.g. UF_xxx). If a Uid is not unique, an error will occur.
NB: A UID SHOULD CONSIST OF LETTERS (ABC), NUMBERS (123) OR/AND UNDERSCORES (_). CHARACTERS LIKE SPACE, DASHES OR SPECIAL CHARACTERS ARE TECHNICALLY POSSIBLE BUT NOT RECOMMENDED AS THESE ARE NOT SUPPORTED BY THE $[$<ITEM>.<COL>.<TYPE>] SYNTAX.
WARNING: IF YOU USE THE CONTENT CREATOR TO PLACE DATA ONTO OTHER B1UP WINDOWS IT IS HIGHLY RECOMMENDED THAT YOU USE THE PREFIX "BOYX_" FOR UID AS THIS IS A SPECIAL PREFIX B1UP UNDERSTAND SO IT CAN CONFLICTS DURING UPGRADES. EXAMPLE IF YOU WISH TO ADD A BUTTON ONTO THE RECURRING INVOICE WINDOW CALL IT "BOYX_01 " AS THE UID.
|
Type (Mandatory)
|
With the content creator it is possible to create the following item types:
Type
|
Description
|
Button
|
A button with a caption.
|
Checkbox
|
A checkbox can have a checked or unchecked value
NB: A CHECKBOX MUST BE BOUND TO A USER DEFINED FIELD (ALPHA REGULAR 1) IN ORDER TO FUNCTION PROPERLY (DBDS: TABLE AND DBDS: FIELD)
|
Combo box
|
A combo box to show valid values. The values can come from the user defined fields valid values (bound using DBDS: Table and DBDS: field) OR from the Valid Values property described below.
|
Edit text
|
A text field where data can be entered. If these data should bind to a specific record you should data bind the item using the DBDS: Table And Dbds: Field.
|
Folder (Tab)
|
A folder or tab where other items can be placed on.
NB: YOU CAN ONLY ADD ADDITIONAL TABS TO AN EXISTING FOLDER-COLLECTION (YOU CAN’T MAKE A NEW COLLECTION FROM NOTHING).
NB: PLEASE NOTE THAT YOU WILL NEED TO DO ADDITIONAL WORK WITH THE B1 VALIDATION SYSTEM AND MACRO, BEFORE YOU CAN TAKE ADVANTAGE OF THE NEW TAB.
NB: IF YOU CREATE A FOLDER, YOU SHOULD DEACTIVATE THE AFFECTS FORM MODE PROPERTY OR ELSE PRESSING THE NEW TAB WILL CHANGE FORM MODE
|
Label
|
A simple label showing a caption. These are normally linked to a combo box or an edit text, but it is not mandatory.
|
Linked Button
|
A linked button (Orange arrow) that can open other windows.
NB: THIS SHOULD ALWAYS BE LINKED TO AN EDIT TEXT ITEM USING THE LINK TO PROPERTY.
|
Picture
|
A picture box to show a picture.
NB: A PICTURE MUST BE BOUND TO A USER DEFINED FIELD OF TYPE PICTURE IN ORDER TO FUNCTION PROPERLY (DBDS: TABLE AND DBDS: FIELD)
|
Rectangle
|
A simple rectangle that visually can group other items. Have no other functionality than display.
|
Text area
|
A text area works just like an edit text but contains scrollbars.
|
|
Description
|
Here you can set a description of the item normally shown in the lower left corner of the client. In types Button, Label and Checkbox this is the caption of the item.
|
Left
|
This indicate the left position of the item in pixels
|
Top
|
This indicate the top position of the item in pixels
|
Width
|
Here you can set the width of the item. If nothing is entered, the default width is used
NB: ITEM TYPES: RECTANGLE, TEXT AREA AND PICTURE SHOULD ALWAYS HAVE A WIDTH
|
Height
|
Here you can set the height of the item. If nothing is entered, the default height is used.
NB: ITEM TYPES: RECTANGLE, TEXT AREA AND PICTURE SHOULD ALWAYS HAVE A HEIGHT
|
Form Pane / To Pane
|
Pane level is the information about which folder (tab-page) the item is on. All items of a folder will have the same Pane level. Items that are shown all the time have Pane level 0.
Online Guide: Understanding Pane levels
|
DBDS: Field
|
This property is used if the item should be bound (related) to a user defined field of the current window. A user defined field always starts with ”U_” and can be seen using the system information
NB: ONLY USED IN CHECKBOX, COMBO BOX, TEXT AREA AND PICTURE ITEM TYPES (NOT MANDATORY)
|
DBDS: Table
|
This is the second part of the data-binding, where you enter the name of the table that the user defined field is bound to. As an example, if your field is linked to a business partner, the table is OCRD while if it is linked to items it is OITM.
NB: ONLY USED IN CHECKBOX, COMBO BOX, TEXT AREA AND PICTURE ITEM TYPES (NOT MANDATORY)
|
Edit: Add
|
This checkbox gives you the option to indicate if your item is editable in the window’s add-mode (e.g. If your button can be pressed in add-mode).
|
Edit: Find
|
This checkbox gives you the option to indicate if your item is editable in the window’s find-mode.
|
Edit: Ok
|
This checkbox gives you the option to indicate if your item is editable in the window’s OK-mode.
|
Valid Values
|
Here you can set a collection of valid values a combo box item type should contain. The syntax is as follows: VALUE,DESCRIPTION;VALUE,DESCRIPTION…
Sample: Y,Yes;N,No;P,Perhaps
The above would give 3 options in a combo box.
Alternative you can type SQL:<SQL-sentence>. In order for it to work with this you need to produce an SQL with two columns .. If you do not have at least two you will get an error. If you give it more it will ignore exceeding columns.
Sample: SQL:SELECT Code, Name FROM [@MY_TABLE] WHERE U_ACTIVE = 'Y'
Tip: to include an empty value do it like this:
Sample: SQL:SELECT '', '' UNION ALL SELECT Code, Name FROM [@MY_TABLE] WHERE U_ACTIVE = ‘Y’
NB: ONLY USED IN COMBO BOX ITEM TYPES (NOT MANDATORY)
|
Affects Form mode
|
Use this option if you want an item that does not affect the form mode (e.g. If unchecked and a window is in ok-mode, it will not cause a switch to update mode)
|
Right Justified
|
Use this option to set if data in an edit text field are right-justified or not.
- Not right justified
- Right Justified:
NB: ONLY USED IN EDIT TEXT ITEM TYPES AND TEXT AREA ITEM TYPES
|
Suppress Zeroes
|
Use this option to get edit text fields to show nothing if the value is zero
NB: ONLY USED IN EDIT TEXT ITEM TYPES AND TEXT AREA ITEM TYPES
|
Text Style
|
Use this option to set the text-style of the item (Bold, Italic, Underline, and so on)
|
Fore Color
|
Use this option to set the text-color of the item (RGB value in long representation)
TIP: RIGHT-CLICK THE COLUMN TO PICK THE COLOR
|
Back Color
|
Use this option to set the background-color of the item (RGB value in long representation)
TIP: RIGHT-CLICK THE COLUMN TO PICK THE COLOR
NB: NOT ALL GUI ELEMENTS CAN APPLY COLOR. THE FOLLOWING LIST SHOW WHAT CAN BE COLORED AND WHAT CANNOT
GUI Item type
|
Fore color
|
Back color
|
Button
|
No
|
No
|
Checkbox
|
(Yes) [Only Code render mode due to SDK bug]
|
No
|
Combo box
|
Yes
|
Yes
|
Edit Text
|
Yes
|
Yes
|
Folder (Tab)
|
No
|
No
|
Label
|
Yes
|
Yes
|
Linked Button (Golden arrow)
|
No
|
No
|
Picture
|
No
|
No
|
Rectangle
|
No
|
No
|
Text area
|
No
|
No
|
|
Font-size
|
Here you can set the font-size of the item. If nothing is entered, the default will be used.
|
Linked Object
|
This property is used with linked buttons and decides what the link-button should point to when pressed.
NB: ONLY USED WITH THE LINKED BUTTON ITEM TYPE (MANDATORY)
|
Link To
|
Link to is primary used to tell a linked button where the data to link to is stored (an edit texts Uid), but Link to is also used to link labels and other items together (the little with line under the label link to another item) and to group items together on resizable windows.
NB: MANDATORY FOR LINKED BUTTON ITEM TYPE. OPTIONAL FOR OTHER TYPES
|
Group With
|
Group with is used to link a new Folder (tab) item to an existing folder-collection. Just provide the new Folder with the Uid of one of the existing folders.
TIP: THE LEFT-PROPERTY OF THE FOLDER ITEM CONTROLS WHERE IN THE COLLECTION YOUR TAB IS PLACED
NB: ONLY USED WITH THE FOLDER (TAB) ITEM TYPE (MANDATORY)
|
Val Off / Val On
|
With Val Off/Val On, you can override what data-value of a checkbox is considered as the checked and what is for unchecked. If not set the default valOn/off is used (Val On = Y, Val Off = N).
NB: ONLY USED WITH THE CHECKBOX ITEM TYPE (NOT MANDATORY)
|