Display Controls (Magic xpa 2.x)
Display controls can be used to make programs easier to understand and use. They provide a clear and easy user interface, and can also be used to organize large amounts of data in a way that is easy to understand.
Magic xpa provides a rich selection of powerful Display controls that are easy to use. You can put together a complex GUI window in a matter of minutes. The WYSIWYG interface allows you to design your form intuitively and quickly, but you can still control size and location using hard-coded numbers, or change the parameters at runtime.
The buttons in the GUI Control palette are described in the table below.
|
Control
|
Name
|
Description
|
|
|
|
The selection tool in the Control palette. Use this tool to select or unselect a control. You must select a control in order to move, resize or delete it, or to zoom to the Control Properties sheet.
|
|
|
.NET
|
You can upgrade the look and feel of your application by directly placing new .NET controls as part of your user interface.
See .NET Integration.
|
|
|
Browser
|
Inserts a Browser control that enables the display of HTML files.
|
|
|
Check Box
|
Inserts a check box that the user can toggle on/off. Use this type of control to represent logical variables or expressions.
|
|
|
Combo Box
|
Inserts a combo box containing two default items.
|
|
|
Edit
|
Inserts an Edit control. You can attach this type of control to a variable or an expression in the Data property of the Control Properties sheet.
|
|
|
Group
|
Draws a static rectangular box to group a number of controls together visually. You can include a label to describe the group.
|
|
|
Image
|
Inserts a graphic Image control.
|
|
|
Label (Text)
|
Inserts a static Label (Text) control.
|
|
|
Line
|
Draws a graphic line. To define the line’s color, set the Color property in the Control Properties sheet.
|
|
|
List Box
|
Inserts a list box control containing two default items.
|
|
|
OLE
|
Inserts an OLE container. The OLE control is not supported.
|
|
|
Push Button
|
Inserts a push button that the user clicks to launch an event in the project.
|
|
|
Radio Button
|
Inserts a box for radio buttons.
|
|
|
Rich Edit
|
Inserts a Rich Edit control that contains a variable or expression. This control is implemented as a Rich Text control when the text originates from a BLOB variable or expression.
|
|
|
Rich Text
|
Inserts a Rich Text control containing static text that can be formatted during development. The formatting of a Rich Text control is not implemented on the control as a whole, but only during the editing of the selected text of the control.
|
|
|
Subform
|
Displays another form within the current form.
|
|
|
Tab
|
Inserts a Tab control containing two default tabs. You can place other control types such as Edit controls and Push Button controls on a Tab control.
|
|
|
Table
|
Inserts a Table control into the form. You can place other control types, such as Edit controls, and push buttons on a Table control.
|
|
|
Tree
|
Inserts a Tree control that displays a selected task data view in a tree style with parent and child nodes.
|
|
|
|
|
|
|
Rectangle
|
The Rectangle control is no longer supported (since version: 2.0).
|
|
|
Ellipse
|
The Ellipse control is no longer supported (since version: 2.0).
|
|
|
Vertical Slider
|
The Slider controls are no longer supported (since version: 2.0).
|
|
|
Horizontal Slider
|
The Slider controls are no longer supported (since version: 2.0).
|
You can access the controls from :
From the Control palette, you can right-click on any of the controls. This displays all of the models defined for the control. If you click one of the models, the control that you place on the form will automatically have the model assigned to it.
After you have entered a control into a form, you can assign properties to the control. Select the control with the mouse and press F5 or double-click to zoom to the Control Properties sheet.
The Control Properties sheet lets you assign variables as Data Source properties for controls, and to define properties for their format. It is important to note that the tab order in which Magic xpa accesses the variables at runtime is specified by the sequence of controls on the form.
If a variable is chosen as a Data property in more than one control in the window layout, only the last selection is updated at runtime. If it is necessary to show a variable more than once within a window layout, you must create a virtual variable for each extra occurrence of that variable, and then display the virtual variable.
When you are creating a text-based form (Class > 0), control properties that are not supported in text-based forms are disabled. This is true also for Java forms and HTML forms.
Control properties are organized into separate categories, varying with each type of control. The properties in each list also vary as appropriate to the control.
Platform specific:
Mobile support is not currently available for the Rich Edit, Rich Text and Tree controls.
Android and iOS support is not currently available for the .NET and List Box controls.
Variable Palette
How Do I Automatically Drop Form Controls Using a Specific Control Model?
