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 ).