company logo

ControlContext :: createControl - Create dynamical Control

The function creates a control for the field control passed and returns the control context. In order to activate control after creation, the bActivate option must be passed as true. When not activating the control, is must be activated explicitly later on by the application (activated(true)).

Return value:  Control context ( odabagui::ControlContext & )

ControlContext classes are created for field (ADK_Field) as well as for control (ADK_FieldControl) resources.

When referring a field resource, the field context will overload the context implemented for the subordinated field control (control context).

Implementation details

odabagui::ControlContext & ControlContext  :: createControl ( odaba::String &sResource, odaba::Property &cControlProperty, odabagui::Size &cSize, odabagui::Point &cPoint, odaba::String &sAccessPath, int32 iDisplayLevel, int32 iResourceID, bool bActivate )
  • sResource - Name of resoure

    "ok_button"        // button in the current window

    "address.street"   // line edit in the address subwindow

    ".name"            // line edit in the upper control (window)

  • cControlProperty - Property handle for control resource

    The property handle refers to an ADK_FieldConrol property within a design class (ADK_Class).

  • cSize - Size of rectangle

    Size is usually defined in pixel width and pixel height.

  • cPoint - Constant area position
  • sAccessPath - Data access path
  • iDisplayLevel - Display level

    The display level is be a value greater or equal to zero. The value must not exceed the number of display levels in the control (e.g. the number of tabs in a tab control).

    Display level 0 causes hiding all controls except those defined on level 0, which are visible on any display level.

  • iResourceID - Internal resource identification

    The internal resource identification is a unique number within the resource database of a project. The number is assigned to the resource on demand.

  • bActivate - Activate option

    The activate option indicates, whether a control is to be activated after being created (true) or not (false).