RadBuilder Visual and Nonvisual Objects
Button
Represents a push button that contains a text caption. A Button is a
general-purpose push button for use in applications. The OnTap event
occurs when a user taps the object using a finger or a similar device.
Add actions for OnTap event to to specify what happens when the user
taps the object.
Properties
Text: Specifies the text that will be displayed over the surface of
this object.
Style: Specifies the button style.
ImageButton
ImageButton is a button with an image and text includes text, detail and footer.
Properties
Bitmap: Specifies the bitmap that appears on the ImageButton.
ImagePosition: Specifies where the image appears on the ImageButton.
ImagePosition indicates whether the Image appears on the left of the button, the right of the button, the top or the bottom.
ImageWidth: Specifies the width of the image appears.
ImageHeight: Specifies the height of the image appears.
ImageRadius: Specifies the distance from a corner to the start point of the corner shape customization for the image.
Text: Specifies the caption or title of the button.
Spacing: Determines the number of pixels between the image (Bitmap) and the text.
Margin: Specifies the number of pixels between the edge of the image, text and the edge of the button.
Detail: Specifies an additional text description
of the ImageButton object. The detail text description can appear under
the text.
DetailFontColor: Specifies detail text font color.
DetailFontSize: Specifies detail text font size.
Footer: Specifies a footer text description of
the ImageButton object. The footer text description can appear at
bottom of the text area.
FooterFontColor: Specifies footer text font color.
FooterFontSize: Specifies footer text font size.
TextSpacing: Determines the number of pixels between the text and the detail text.
Label
Represents a graphical object used to display text in forms.
Use Label objects in forms to add text that the user cannot edit. This
text can be used to label another object.
To add an object to a form that displays text that a user can scroll or
edit, use a Memo or Edit object.
Properties
Text: Specifies the text that will be displayed over the surface of
this object.
Text
Represents a graphical object used to display text in forms with
multi-lines.
To add an object to a form that displays text that a user can scroll or
edit, use a Memo or Edit object.
Properties
Text: Specifies the text that will be displayed over the surface of
this object.
Shape
Represents 2D graphic primitives - Lines, Rectangles, RoundRects and
Ellipse.
Properties
ShapeType: Determines the shape for the shape object.
LineType: Specifies how to place the line inside the shape object with
Line ShapeType.
The LineType value should be one of the type: Diagonal, Top, Left,
Button and Right.
Note: To properly use the LineType property, you must set the ShapeType
property to Line
Radius: Specifies the distance from a corner to the start point of the
corner shape customization for Rectangle shape.
During design time, the maximum possible value of Radius is limited by
the half of the smallest side.
If Radius=0, then no corner shape customization is used.
Note: To properly use the Radius property, you must set the ShapeType
property to Rectangle
Image
Represents a graphical object used to display images on a form.
Use a Image object whenever you need to put an image on a form. You can
use the Bitmap property to specify the image that will be displayed.
Properties
Bitmap: Specifies a Bitmap picture to be displayed onto the surface of
this image object.
Setting Bitmap at design time brings up the Bitmap Editor, which can be
used to specify the file that contains the image you want to display.
Edit
General-purpose edit box.
Note: For a multiline edit object, use Memo object.
Properties
Text: Contains the text displayed by this edit object.
Use the Text property to read the text of this edit object or to
specify a new string to be displayed.
Memo
Memo is a multiline text editing object, providing text scrolling.
Use Memo to place a standard multiline edit object on a form. Multiline
edit boxes allow the user to enter more than one line of text. They are
appropriate for representing large amounts of text.
To limit the changes made to the memo object, use properties such as
ReadOnly or Enabled.
Properties
Text: Contains the multiline text displayed by this object.
ReadOnly: Specifies whether the memo's text can be changed.
ReadOnly equals to True forbids any modification of the text in the
memo object.
ComboEdit
An edit box with a list of predefined choices.
ComboEdit stores the predefined choices in its Items property, which
can be edited at design time.
Properties
Text: Contains the text displayed by this edit object.
Use the Text property to read the text of this edit object or to
specify a new string to be displayed.
Items: A persistent object storing the list of items.
To add items to a ComboEdit at design time, use the Items property. The
items can be entered in the String List Editor.
ComboBox
A ComboBox is a button with a list box attached to it.
Click the button to display the list. You can select an item from the
list and it will appear as the button's text. You cannot type text
directly into the combo box button.
Properties
ItemIndex: Specifies the index of the currently selected item.
Gets or sets the index of the item that is selected in the combo box.
The first item in the list has index 0, the second item has index 1,
and so on. If no item is selected, the value of ItemIndex is -1.
Items: Specifies the items in the drop-down list.
Use Items to get or set the list of items in the drop-down as strings.
NumberBox
Use the NumberBox when you need a box that allows typing only numbers.
The content of the number box depends on what the user types.
Properties
Value: Contains the number displayed by an object.
ValueFloat: Data type used by the edit boxes that can display float or
integer only.
DecimalDigits: The number of decimals of the number displayed.
VertIncrement: Represents the value with which the number is
incremented or decremented when, while holding down the mouse button,
you move the mouse vertically.
VertIncrement represents the value added or decreased from the number
when, while holding down the mouse button, you move the mouse up or
down.
Max: Contains the maximum value the number displayed by the object can
show.
Min: Contains the minimum value the number displayed by the object can
show.
TrackBar
Represents a general-purpose track bar for use in applications where
tracking is required.
TrackBar represents a track bar that can be used for various types of
tracking operations. Move the slide indicator by dragging it to a
particular location or click (Tap) in the bar to change its Value.
Properties
Value: Specifies the current value of this track bar.
Set or get Value to specify or obtain the current value of this track
bar. You can set Value at design time or run time, with any value
within the interval delimited by Min and Max.
Frequency: Specifies the number of positions the slider advances with
each move.
Use the Frequency property to specify how many steps at once the slider
advances with each move. For instance, if you set Frequency to 10, Min
to 0, and Max to 100, then there are only 10 steps for this slider to
move within the 0 to 100 range; Value is incremented or decremented
with 10 divisions.
Frequency is a floating-point Single value; setting Frequency to 0
enables this track bar to increment or decrement by 0.01 divisions by
step. Setting Frequency to any integer value (for instance 1, or 5, and
so on) will enable this track bar to increment or decrement by the
specified value.
However, please take into consideration that if you set Frequency to
any value greater than 0 and you try to assign a value to Value, then
your value will be converted to the nearest multiple of Frequency.
Vertical: The track bar is rendered with the bottom-to-top orientation
or not.
Max: Specifies the maximum value of this track bar for the maximum
position of the slider.
Use the Max property to set a maximum value up to which the slider of
this track bar can go. For instance, if Max is set to 100 (a default
value), then attempting to move the slider to the maximum will result
in a Value of 100.
Min: Specifies the minimum value of this track bar, for the minimum
position of the slider.
Use the Min property to set a minimum value down to which the slider of
this track bar can go. For instance, if Min is set to 0 (a default
value), then attempting to move the slider to the minimum will result
in a Value of 0.
CheckBox
Represents a check box that can be either on (selected) or off
(cleared).
Properties
Text: Specifies the text that will be displayed over the surface of
this object.
IsCheck: Specifies whether the state of this check box is selected or
cleared.
Set the IsChecked property to True in order to force this check box's
state to be selected. The check box becomes cleared once you click
(Tap) it again.
Switch
Represents a two-way on-off switch for use in applications.
Use a Switch whenever you need to provide the user with a two-way
on-off switch.
Properties
IsChecked: Specifies the state of this switch object (on or off).
Use the IsChecked property to specify the status of this switch (on -
True; off - False).
DateEdit
Represents a single-line editable text box containing a date.
When you click or tap the DateEdit object, it displays a date picker
that allows you to select a date.
Properties
Date: Represents the date that is shown in the text box of the DateEdit
object.
DateFormatLong: Specifies a long date (day of week, month date, year),
such as Monday, January 27, 2014 or not.
TimeEdit
Represents a single-line editable text box containing a specified time.
When you click or tap the TimeEdit object, it displays a time picker
that allows you to select a time.
Properties
Time: Represents a time that is displayed in the text box of this
object.
TimeFormatLong: Specifies a long time (hour, minute, second), such as
12:02:01 PM or not.
ColorBox
Represents a combo box that allows you to select an alpha color from a
color spectrum.
A ColorBox behaves like a standard ComboBox, with the difference that,
while in drop-down mode, it displays a color spectrum represented as a
HueTrackBar, an alpha channel track bar, a color quad and a HEX color
value edit box. These make the ColorBox a great color selector.
Properties
Color: Specifies the color selected by this color box object.
Set or get the Color property in order to specify or obtain the alpha
color selected by this color box object.
UseAlpha: Specifies whether this color box object will display the
alpha channel track bar when in drop-down mode.
Set the UseAlpha property to True to make this color box display the
alpha channel (transparency) track bar, when it is in drop-down mode.
Set UseAlpha to False to use solid non-alpha colors.
Grid
Grid represents a grid object designed to simplify the handling of
strings.
Properties
RowHeight: Specifies the height of each row of this grid, in pixels.
Read RowHeight to determine the size of each row in the grid. If the
underlying grid is too tall to appear in the object, then the user must
scroll to see the entire content of the grid.
AlternatingRow: Specifies whether the alternate rows of the Grid object
have a background color.
RowSelect: Specifies whether a click or tap on a row in the Grid object
selects that row.
AlwaysShowSelection: Specifies if an update of the content of the cell
also immediately selects that cell.
Header: Specifies whether the header row of the Grid object is
displayed.
Data: Columns and rows strings of the grid.
Chart
The Chart object lets you present information in a graphical format
that enables users to quickly grasp the information.
Chart includes chart series types: Line, Bar, Area, Point and
Pie.
Properties
Series: Add, Edit and Delete series.
Data: Edit the series data.
Title: The chart title.
Foot: The chart footer.
BackColor: The app will paint the whole chart background with the
chosen color.
LegendPosition: If the Legend is set to the side (left or right) of the
Chart the contents of the Legend, by default, sit as a list from top to
bottom. If the Legend sits below or above the Chart then the Legend
contents are placed side by side.
Chart3DPercent: Controls the depth of the 3D effect.
LabelsAngle: Specifies the amount (in degrees) by which the labels of
the serie values are rotated from the x-axis.
FontSize: The height of the chart font in points.
FontColor: Specifies the color for the Chart font.
ColorStyle: Select color palette for the series points.
ListView
Represents a list view object that you can use to hold and present various types of items.
The ListView displays a collection of items in a list that is optimized
for binding dataset with DataSet, FieldName, DetailFieldName,
BitmapFieldName and ButtonTextFieldName properties of the object and
for fast and smooth scrolling.
You can add items to a ListView by binding to a dataset object (DBTable
or DBQuery) with the DataSet property of the object. The items in the
list view can have one or more of the following appearance features:
A caption text, using the FieldName property to bind to a dataset field
A detail text, using the DetailFieldName property to bind to a dataset field
An associated image, using the BitmapFieldName property to bind to a dataset image field
A button attached, using the ButtonTextFieldName to bind to a dataset
field (The ItemAppearance is ImageListItemBottomDetailRightButton or
ImageListItemRightButton)
properties
Items: You can add items and set the Icon (Bitmap),
Text, Detail, ButtonText properties of the items and link them to Forms (Show the form when users tap the item)
and Value objects (The Value object actions will be done when users tap the item) for actions.
ItemAppearance: Name of the appearance of regular list view items.
ItemHeight: Height in pixels of each regular list view item.
ShowSelection: Determines whether the selection is visible when selecting list view items.
TextFontColor: Specifies the font color of the items caption text.
TextFontSize: Specifies the font size of the items caption text.
DetailFontColor: Specifies the font color of the items detail text.
DetailFontSize: Specifies the font size of the items detail text.
ButtonText: Specifies the text of the items buttons, if the ButtonTextFieldName does not bind any dataset field.
ButtonFontColor: Specifies the font color of the items button text.
ButtonFontSize: Specifies the font size of the items button text.
ButtonWidth: Specifies the width in pixels of the items button.
ImageWidth: Specifies the width in pixels of the items image.
ImageHeight: Specifies the height in pixels of the items image.
DataSet: Set DataSet to the name of an existing
dataset object (DBTable or DBQuery) at design time. At runtime the data
from a dataset object is provided to the object.
FieldName: Specifies the field from
which the items caption text displays data. Access by the object to the
dataset in which the field is located is provided by a DataSet object,
specified in the DataSet property.
DetailFieldName: Specifies the field from which the items detail text displays data.
BitmapFieldName: Specifies the image field from which the items image displays data.
ButtonTextFieldName: Specifies the field from which the items button text displays data.
Panel
Container object represents a generic general-purpose panel used to
hold multiple objects for organizing purposes.
Use Panel objects when you need to provide the user with a way of
placing multiple graphical objects on a surface for organizing
purposes.
Panels have methods to help manage the placement of child objects
embedded in the panel. You can also use panels to group objects
together. Panels are typically used for groups of objects within a
single form.
With the Style property, the Panel object can work as a tab set that
has the appearance of notebook dividers. User can tap it from left to
right or from right to left to do tab Slide Transition.
The children objects of the Panel object will become the
individual tabs of this panel object. The captions of the tabs display
the children's object name if the panel style is TabDefault, TabTop or
TabBottom.
Properties
Style: Specifies the panel works as normal panel or notebook at run time.
NormalPanel: Normal panel, not tab notebook style.
TabDefault: The tabs are at the default position for the object on the target platform.
TabTop: Tab notebook style and the tabs are at the top of the object at run-time.
TabBottom: Tab notebook style and the tabs are at the bottom of the object at run-time.
TabDots: Tab notebook style and the tabs are rendered as small dots at the bottom of the object.
TabNone: Tab notebook style but tabs are not visible at run-time.
User can tap it from left to right or from right to left to do tab
Slide Transition.
ClipChildren: Specifies whether the current container object has a
clipped child.
ClipChildren is True if the object has a clipped child, and False
otherwise.
CalloutPanel
A container for extra information relevant to another item, with a
visual indicator pointing to that item.
Properties
CalloutPosition: Defines the side where the callout pointer appears.
Set CalloutPosition to one of the Top, Left, Bottom, or Right constants
to define the side on which the callout pointer should appear.
CalloutLength: The length of the visual element that points at the area
of interest.
CalloutWidth: The width of the visual element that points at the area
of interest.
CalloutOffset: The position of the callout pointer, relative to the
center or edges of the side on which it appears.
Radius: Specifies the distance from a corner to the start point of the
corner shape customization.
ClipChildren: Specifies whether the current container object has a
clipped child.
ClipChildren is True if the object has a clipped child, and False
otherwise.
ScrollBox
Represents a scrolling area in a form. Set the AutoArrange property
True, the ScrollBox will auto arrange it's children at run-time.
Properties
Transparent: Indicates whether the object is transparent or not.
AutoArrange: Auto arrange it's children at run-time.
Columns: Specifies the number of columns on which
to display the object's children at run-time when the AutoArrange
property is True.
ItemHeight: Specifies the height of the object's children at run-time when the AutoArrange property is True.
Spacing: Determines the number of pixels between the object's children at run-time when the AutoArrange property is True.
Splitter
Splitter divides the client area of a container object into resizable panes.
Add a splitter to a container object between two aligned objects to
allow users to resize the objects at runtime. The splitter sits between
a object aligned to one edge of the container object and the objects
that fill up the rest of the client area. Give the splitter the same
alignment as the object that is anchored to the edge of the container
object. When the user moves the splitter, it resizes the anchored
object. This, in turn, changes the client area of the container object,
and the objects that fill up the rest of the client area resize
accordingly.
Use each object on the container object as a separate pane. After each
pane is placed, place a splitter with the same alignment to allow that
pane to be resized. The last pane to be placed on the container object
should be client-aligned, so that it resizes automatically to fill up
the remaining space after all other panes are resized.
Properties
MinSize:
Specifies the minimum size, in pixels, of the objects that are being
split in case of sliding the splitter to the maximum of one of the
left, right, top, or bottom margins.
Value
Nonvisual object works as variables.
Properties
BooleanValue: A boolean variable, True and False.
IntegerValue: A integer variable.
ColorValue: A color variable.
FloatValue: A float (double) variable, 5.0 x 10^-324 .. 1.7 x 10^308
DateValue: A date variable, represents a date value.
TimeValue: A time variable, represents a time value.
StringValue: A string variable, a string represents a sequence of
characters.
TextValue: A string variable, a string represents a multiline text.
EnumType: Enumerated value type.
EnumValue: Enumerated value.
Loop: Implement IF-THEN-ELSE, WHILE-LOOPS and FOR-LOOPS statement actions
with the OnBooleanValue event that triggered when the BooleanValue
prperty changed from False to True. The value can be:
None: Implements
a conditional statement. When the BooleanValue property changed from
False to True, the OnBooleanValue event will be triggered and the
actions will be executed once.
WhileLoop: Implements conditionally iterate a
statement. Executes the OnBooleanValue event actions repeatedly until
the value of the BooleanValue is false, when the BooleanValue prperty
changed from False to True (OnBooleanValue event).
ForLoop: Implements an iterative loop. The
OnBooleanValue event actions are executed and decrements the
IntegerValue property by 1 repeatedly UNTIL the value of the
IntegerValue property is 0 (or less then 0) or the value of the
BooleanValue property is false, when the BooleanValue prperty changed
from False to True (OnBooleanValue event).
TranslateData: Pairs of strings separated by control charactors.
TranslateCtrlCharacter: Specifies control charactor.
TranslateSource: The translate source string.
TranslateTarget: The translate result string.
For example
TranslateCtrlCharacter: ~
The TranslateData:
1~ON
2~OFF
3~Unknown
Use the SetPropertyValue action to set the TranslateSource "1", the TranslateTarget property will be "ON".
If TranslateSource = "1" then TranslateTarget = "ON"
Else If TranslateSource = "2" then TranslateTarget = "OFF"
Else If TranslateSource = "3" then TranslateTarget = "Unknown"
Else TranslateTarget = "".
Effect
Creating Shadow, Blur, Glow, InnerGlow, Bevel and Reflection effects
for visible objects. You can attach and apply an effect to any visual
object.
Animation
Animations modify property values over time. They can be started
automatically or manually, both with an optional delay. After the
animation has run its course over the defined time period, it can stop,
start over, or do the same but in reverse.
Audio
Nonvisual object for audio file playback.
Properties
FileName: Specifies the audio file name played by the current object.
Active: Set Active to True to start playing the audio file. Set Active
to False to stop playing the file.
Timer
Use a Timer object to repeat specific actions after a given time
interval.
The execution of the timer occurs through its OnTimer event. Timer has
an Interval property that determines how often the timer's OnTimer
event occurs.
Properties
Interval: Determines the amount of time, in milliseconds, that passes
before the timer object initiates another OnTimer event.
Interval determines how frequently the OnTimer event occurs. Each time
the specified interval passes, the OnTimer event occurs and the actions
will be done.
Enabled: Controls whether the timer generates OnTimer events
periodically.
Use Enabled to enable or disable the timer. If Enabled is True, the
timer responds normally. If Enabled is False, the timer does not
generate OnTimer events.
DBTable
A dataset that works with a single database table.
Use DBTable to browse a database table and edit its records.
Properties
TableName: Gets / sets table name to open.
Fields: Use the Fields Editor at design time to create persistent lists
of the field components used by the datasets in your application.
Persistent fields component lists are stored in your application, and
do not change even if the structure of a database underlying a dataset
is changed. All fields in a dataset are either persistent or dynamic.
Add new persistent fields to a dataset and create data fields and
lookup fields.
With the Fields Editor to access the following commands and set the
fields properties:
Add All Data Fields: Creates persistent fields for every field
in the underlying dataset.
New Data field: Create new persistent fields as additions to or
replacements of the other persistent fields in a dataset.
New Lookup Field: Create new lookup field. A lookup field is a
read-only field that displays values at runtime based on search
criteria you specify. In its simplest form, a lookup field is passed
the name of an existing field to search on, a field value to search
for, and a different field in a lookup dataset whose value it
should display.
Edit: Edit the fields properties.
Delete: Delete the field from the field list.
Active: Specifies whether or not a dataset is open.
Use Active to determine or set whether a dataset is populated with
data. When Active is false, the dataset is closed; the dataset cannot
read or write data and attached objects can not use it to fetch data or
post edits. When Active is true, the dataset can be populated with
data. It can read data from a database. Active datasets can post
changes.
Remote: Specifies whether or not a dataset
connect to remote dataserver - RadBuilder DataServer for the
multi-tiered applications.
RemoteHost: Specifies the host for the remote connection. It should be remote computer (RadBuilder DataServer) IP address.
RemotePort: Specifies the port for the remote connection.
RemoteUserName: Specifies the user name for the remote connection.
RemotePassword: Specifies the password for the remote connection.
Note: The
RemoteHost, RemotePort, RemoteUserName and RemotePassword properties
should match the remote data server computer IP address,
RadBuilder DataServer connections settings (Port, User Name and
Password).
The remote data is readonly.
For more information about RadBuilder DataServer and Multi-tiered Applications: RadBuilder DataServer
DBQuery
A dataset capable of executing SQL queries.
Use DBQuery to execute SQL queries, browse the result sets, and edit
the result set records.
Properties
SQL: Contains the text of the SQL statement to execute for the query. It supports parameterized SQL statement:
A parameterized
SQL statement contains parameters, the values of which can be varied at
design time or runtime. Parameters can replace data values, such as
those used in a WHERE clause for comparisons, that appear in an SQL
statement. The names of parameters are names of Value objects those
exist and the parameter values are StringValue properties of the Value
objects. For example, in the following SELECT statement:
SELECT * FROM Country WHERE Name=":Value1" or Capital=":Value2" and Population<:Value3;
In this SQL statement, :Value1, :Value2 and
:Value3 are placeholders for actual values supplied to the statement at
run time by your application. Note that the names of parameters begin
with a colon. The colon is required so that the parameter names can be
distinguished from literal values.
The DBQuery objects use the StringValue
properties of Value objects to store these values. Before the dataset
can execute the query, you must supply values for the StringValue
properties of the Value objects with SetPropertyValue actions or other
actions.
Fields: Use the Fields Editor at design time to create persistent lists
of the field components used by the datasets in your application.
Persistent fields component lists are stored in your application, and
do not change even if the structure of a database underlying a dataset
is changed. All fields in a dataset are either persistent or dynamic.
Active: Specifies whether or not a dataset is open.
Use Active to determine or set whether a dataset is populated with
data. When Active is false, the dataset is closed; the dataset cannot
read or write data and attached objects can not use it to fetch data or
post edits. When Active is true, the dataset can be populated with
data. It can read data from a database. Active datasets can post
changes.
Remote: Specifies whether or not a dataset
connect to remote dataserver - RadBuilder DataServer for the
multi-tiered applications.
RemoteHost: Specifies the host for the remote connection. It should be remote computer (RadBuilder DataServer) IP address.
RemotePort: Specifies the port for the remote connection.
RemoteUserName: Specifies the user name for the remote connection.
RemotePassword: Specifies the password for the remote connection.
Note: The
RemoteHost, RemotePort, RemoteUserName and RemotePassword properties
should match the remote data server computer IP address,
RadBuilder DataServer connections settings (Port, User Name and
Password).
The remote data is readonly.
For more information about RadBuilder DataServer and Multi-tiered Applications: RadBuilder DataServer
DBNavigator
DBNavigator (the database navigator) is used to move through the data
in a dataset and perform operations on the data, such as inserting a
blank record or posting a record.
Properties
ConfirmDelete: Determines whether a message box appears asking you to
confirm record deletions initiated using the database navigator.
VisibleButtons: Determines the buttons that appear on the binding
database navigator.
KinveyCloud
Contains information about the Kinvey cloud service connection and
methods to create, retrieve, update, and delete objects in the cloud.
KinveyCloud is a non-visual object that sets up Kinvey connection
properties such as AppKey, AppSecret, MasterSecret, and UserName and
call the object methods to use the Kinvey cloud service as backend
storage.
Properties
AppKey (AppId)
AppSecret
MasterSecret
UserName
Password
ProxyServer
ProxyPort
ProxyUsername
ProxyPassword
Methods
SaveDataToCloud: Save object property value to cloud.
LoadDataFromCloud: Retrieve object property value from cloud.
DeleteDataFromCloud: Delete cloud data from cloud.
Note: it does not support image or file storage.
|