Data Binding

You can connect the data of the Dataset object to the component to display text or set the property value of the component. Then, the value edited in the component is reflected as the data of the Dataset object. Connecting data to components is called data binding. Like the Grid component, you can connect all data of the Dataset object, or you can connect only the specific column data corresponding to the selected Row as with the Edit component.

Configuring Data Binding

Data can be bound by dragging and dropping the Dataset object created when designing the form onto the component or by selecting the binding-related property in the property window.

When the Dataset object is dragged and dropped onto a component, the format property value setting, Bind InnerDataset, or Bind Item Editor function is called according to the component type. You can specify the properties and column information to be connected in each setting window.

formats Property Value Setting

Components with binddataset, formats properties like Grid, ListView components automatically set the formats property value according to the Dataset object when dragging and dropping the Dataset object or setting the binddataset property value in the property window.

The formats property value can be modified in the desired format in the Grid Contents Editor or the ListView Contents Editor.

Bind InnerDataset

When a Dataset is bound to components that can display data in a list form, such as List Box or Combo, the Bind InnerDataset is accessed because it can designate the Dataset column to use in a list.

The columns that can be set may vary depending on the component. Please refer to the table below.

Bind Item Editor

For components that have the innerdataset property when dragging and dropping the Dataset object, you can select Bind InnerDataset or Bind Item. For components without the innerdataset property, Bind Item Editor is executed immediately.

When a Dataset is bound to a Form or component, it is displayed in the Project Explorer window on the item for easy verification, as shown below:

Bind Dataset Editor

If you select a Form object or component on the design screen and select "Bind Dataset" from the context menu, you can configure multiple Dataset objects and binding settings.

Adding & Editing Bind Item

Create Component & Bind Item Editor

Like the Bind Item editor, this editor is also used to bind a Dataset to a component. However, the difference is that it is used when you want to bind a Dataset while creating the target component. Through the Bind Item editor, in contrast, you can bind a Dataset only to existing components .

If you drag and drop a Dataset object onto the Form area while pressing the Ctrl key, you can open the edit window.

Displaying & Editing Bind State Icon

You can see the state of Dataset binding by right-clicking the Form design pane to open the context menu and selecting [State View > Bind]. In this mode, you can identify to which components Datasets are bound.

For the bound component, the Dataset icon is displayed in the lower right corner, and when you click the icon, Bind Item Editor is displayed.

Editing in the Property Window

You can add or edit the Bind Item for each property by selecting the component and clicking the [Bindable] icon in the property window.

Checking Data Binding Information

Invisible Objects Pane

Nexacro Studio provides the Invisible Object area where you can manage invisible objects, which you cannot see physically but use in developing an app. The Invisible Object area is provided in the form of a dockable window.

If the Invisible Object window is not displayed, open the design menu and select [Show Invisible Object Area].

You can change the icon display types by opening the context menu from the Invisible Object window.

If there are many items in the Invisible Object window, a filtering function is provided to find the desired item immediately. Displays objects whose id matches the input text for filtering in a drop-down list. The list is sorted alphabetically by the id property value.

When you select the desired object from the list, the object becomes selected.

You can use multiple filtering entries using separators (spaces, commas, semicolons).

Binding Components List Pane

This pane shows the components that are bound to the selected Dataset in the Invisible Object pane. If you bring a mouse cursor over a certain component listed in the pane, a tooltip will appears, telling you the information on the relevant binding. Double-click the component item or select "Edit" from the context menu to run the Bind Dataset editor.

Contents Editor

Grid Contents Editor

The Grid Contents Editor is used to edit the Grid’s contents properties. There are many cell unit properties besides the properties that can be seen in the Properties window.

Access the Grid Contents Editor by double-clicking the Grid component on the Design Window.

The Grid Contents Editor is composed of the main editor window and the Design Source window.

In the main edit window, you can add or delete a cell by using the popup menu and shortcut keys, or can edit properties. The main edit window displays the column index at the top, followed by the head, body, and summary.

Main Editor

You can also find the same features at the context menu opened from the Grid Contents Editor.

If there are too many rows, double-click one of the row category areas, which are located on the left end of the editor. The first double-clicking will single out the relevant band, and the following double-clicking will return to displaying all the bands.

Format

Sometimes, you need to look at the same data from various perspectives or hide some part of data due to the authorization issue. In these cases, you can set multiple formats for one Grid.

You can either add a new format or modify an existing one after copying it. You are required to specify the formatid property of a Grid object in order to devise settings specific to a certain format.

Design Source

The Design Source tab of the Grid Contents Editor shows the structure of a Grid in the form of XML. You can change source codes directly here.

ListView Contents Editor

A ListView component has more properties than what we can see in the Properties pane, and those additional properties are affiliated with each band or cell. The ListView Contents Editor is used to edit such additional properties.

You can open the ListView Contents Editor by double-clicking a ListView on the design pane.

The ListView Contents Editor is composed of the main editor, band editor, properties pane and Design Source pane. With the main editor, you can add/delete the body or detail band or can edit properties by using the context menu or shortcuts. The column on the left side of the main editor can be divided into the body and detail bands. The properties pane on the right side presents property values for each band or cell.

Main Editor

You can also find the same features at the context menu opened from the ListView Contents Editor.

Band Editing Mode

You can enter the band editing mode from the main editor by selecting the menu item [Edit Body] or [Edit Detail].

Format

Sometimes, you need to look at the same data from various perspectives or hide some part of data due to the authorization issue. In these cases, you can set multiple formats for one ListView.

You can either add a new format or modify an existing one after copying it. You are required to specify the formatid property of a ListView object in order to devise settings specific to a certain format.

Design Source

The Design Source tab of the ListView Contents Editor shows the structure of a ListView in the form of XML. You can change source codes directly here.

Json Contents Editor

DataObject 오브젝트처럼 contents 속성값이 true이고 메타인포에서 ContentsInfo 태그 contentsformat 설정값이 "json"인 오브젝트의 관련 속성 선택 시 편집할 수 있습니다.

Source 탭에서 코드 수정 시 오류가 발생한 경우 오류 발생 위치를 표시합니다.

Data Path Editor

Dataset 오브젝트에서 binddataobject 속성값으로 DataObject 오브젝트를 선택하고 속성창에서 dataobjectpath 속성 선택 시 편집할 수 있습니다.

XML Contents Editor

This is a content editor that can add basic XML code. It can be edited when the contents property value is true like the Plugin component, and when the related property of the object whose ContentsInfo tag contentsformat setting value is "xml" in meta-info is selected.

Basic Contents Editor

This is a content editor that can generate the XML code according to the specified format. It can be edited when the contents property value of the object is true and the related property of the object whose ContentsInfo tag contentsformat setting value is "ObjectItem" in meta-info is selected.

The type and number of items that can be added depend on the typename, maxoccurs, and minoccurs setting values defined in the object.

Adding Events

You can add an event to a component by selecting the component, and then Event Edit Mode from the Properties Window. You can enter the event directly, or create it automatically by double-clicking the relevant event listed in the Properties.

The below-mentioned rules for creating an event handler will be applied if you first select a component or multiple components.

The below picture shows an example of creating an event handler. As seen in the below picture, first select two button components. Then, double-click either component on the Design panel or double-click a certain event in the Properties pane. Eventually, you will see an event handler created.