Customizing the display of an Organization Chart control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
Importing the internal window for element description
Importing the internal window that represents an element
Customizing the internal window
Displaying additional information
Modifying the shape of the element
Using several internal windows in the same Organization Chart control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Customizing the display of an Organization Chart control

Overview

To customize the interface of an Organization Chart control, you must use specific internal windows.

Therefore, different internal windows can be used for each Organization Chart control of the same application according to the information displayed in the organization chart.

Importing the internal window for element description

Importing the internal window that represents an element

The display of each element found in an Organization Chart control is based on a specific internal window. This internal window is supplied with WINDEV and it can be imported into a project.

To import this internal window:

Method 1: In the "General" tab of the description window, select the "Preset window" option from "Internal window for the elements". The "IW_WinDevViewOrgElement" window is automatically included in the project.
Method 2: Import the preset window directly: on the "Project" pane, in the "Project" group, expand "Import" and select "WINDEV elements and their dependencies". The "IW_WinDevViewOrgElement" window is found in the "Programs\Data\Preset windows\AAF" directory.

Customizing the internal window

The internal window corresponding to an element of the Organization Chart control can be entirely customized. You have the ability to add new controls for example.

You also have the ability to modify the code of internal window.

Displaying additional information

The information displayed in the internal window corresponds to the elements of the OrgElement variable. You may want to display data specific to the application.

To create the link between an element of the organization chart and an entity of the application (a contributor, a group, ...), use the ID property of the OrgElement variable:

For an organization chart filled by programming, when adding an OrgElement element, the identifier of the entity must be specified in the ID property (an automatic file identifier for example).
For an organization chart based on a data file, the ID property is automatically filled from the links of the recursive link.

In the code of the internal window, the element to display is passed in parameter via an OrgElement variable.

PROCEDURE IW_WinDevVewOrgElement(gOrgElement is OrgElement)

Then, use the ID property to find the additional information that will be displayed via this identifier.

In the following example, the OrgElement variable contains information about a contributor. The ID property contains the identifier of the "Contributor" file.

Then, all you have to do is find the requested information in the other files of the database via this identifier.

// Finds the contributor from his ID
HReadSeekFirst(Contributor, ContributorID, gOrgElement..ID)
// Fills the personal details of the contributor
STC_ORGELEMENT_PHONE = Contributor.Phone
BTN_ORGELEMENT_EMAIL..Caption = Contributor.Email
STC_ORGELEMENT_TITLE = Contributor.LastName + ESP + Contributor.FirstName

Modifying the shape of the element

The BackgroundImage property of the OrgElement variable is used to visually modify the appearance of the element.

This property is used to define the image that will be displayed in the background of the internal window. This enables you to display shapes, for example:

// Absolute (displayed in a square)
Absolute is OrgElement
Absolute..Content = "Absolute"
Absolute..BackgroundImage = "orgdiagram_02_Fuschia.png"
nParent = OrgAdd(ORG_DIAGRAM, Absolute)
// Process (displayed in a diamond)
WarmUp is OrgElement
WarmUp..Content = "Warm up, cool down, filter"
WarmUp..BackgroundImage = "orgdiagram_01.png"
nParent = OrgAddChild(ORG_DIAGRAM, nParent, WarmUp)

Using several internal windows in the same Organization Chart control

Via the internal windows, each Organization Chart control can have a different and unique appearance in the same application.

You also have the ability to use several internal windows in the same Organization Chart control.

This feature is very useful for the organization charts that display different types of elements, with different information.

To configure the internal window that will be used for an element found in the Organization Chart control, use the IWDrawing property of the OrgElement variable.