CONTROL
- Introduction to CTRL
- Control Classes
- Types of Control Functions
- Control graphics
  - Graphics objects
  - Attributes of graphics objects
  - Panel functions
  - Reference Functions
  - Arc
  - AttentionEffect EWO functions
  - Bar trend
  - BarChart3D EWO
  - Button
  - Chart.ewo
  - Calendar
  - Cascade
    - "acceptDrops"
      Specifies whether drop events are enabled for this object.
    - "enableItemId"
      Enables or disables a cascade option.
    - "firstChild"
      The attribute "firstChild returns the Child ID and type for the specified item (item ID) of a cascade.
    - "font"
      Sets the font of an object.
    - "hotKeyItemId"
      Sets a hotkey for an item of a cascade.
    - "insertItemId"
      Inserts a new item at runtime.
    - "moveItemId";
      The function "moveItemId"; changes the place of an item in the cascade.
    - "nextSibling";
      Returns the ID and type of the sibling (the next element on the same level as the defined item (itemID).
    - "removeItem"
      Deletes the specified entry.
    - "text"
      Sets the header text for a cascade.
    - "textItemId"
      Sets the text for a specific item of a cascade.
    - "updatesEnabled"
      This attribute specifies whether updates of a widget (for example, a textEdit, slider, progress bar, zoom navigator, LCD number or thumb wheel) have been enabled.
  - Checkbox
  - Clock
  - Combobox
  - DateTimeEdit EWO functions
  - DialGauge EWO
  - DoubleSpinbox EWO
  - DpTreeView
  - DpTypeView
  - Embedded module
  - Frame
  - GIS Viewer EWO
    WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.
  - Label Functions
  - Layoutgroup functions
  - LCD number
  - Maps Widget - Properties and Functions
  - PDF Viewer EWO
  - PictureFlow EWO functions
  - Pipe
  - Polyline
  - Primitive text
  - Progress bar
  - Radio box
  - Rectangle
  - Reference Functions
  - Scheduler.ewo
  - Selection list
  - Slider
  - Spin button
  - Splitter
  - Tab
  - Table
  - TextEdit
  - Text field
  - Thumb wheel
  - ToggleSwitch EWO
  - Tree widget
  - Trend
  - VideoPlayer.ewo
  - WebView EWO
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CtrlExtension, basics
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.

"firstChild"

The attribute "firstChild returns the Child ID and type for the specified item (item ID) of a cascade.

Synopsis

getValue(string shape,"firstChild",string itemID, string &childID, int &type);

shape.firstChild(string itemID, string &childID, int &type);

Parameters


Parameter	Description
shape	Name of the graphics object
itemID	Item ID. Specify the ID of the item whose child ID and type you want to retrieve.
childID	Child ID (Return value)
type	Type (Return value) CB_ITEM = 0 Item CB_POPUP = 1 Popup (sub menu) CB_SEPARATOR = 2 Separator

Return Value

Error

Description

The attribute "firstChild returns the child ID and type for the specified item (item ID).

Example

In the example below, the child ID and type are returned for the item with the ID 1.

main(string id)
{
  string i,j;
  i = "1";
  string obj = "CASCADE_BUTTON1";
  int t;
  getValue(obj, "firstChild",i,j,t);
  DebugN("ITEM ID",i, " CHILD ID", j, " TYPE", t);
}

Assignment

Cascade