Home2L - C/C++ API v1.4-0-g38cc (2024-05-25)
Smart Tools for a Private Home
Modules
Widgets

Description

Collection of UI widgets.

This module contains the collection of common UI widgets or widget extensions.

Widget extension classes are derived from CWidget and provide some extra functionality, but are typically not used by themselves (e.g. CModalWidget or CCursorWidget). They may be combined with other classes derived from CWidget by means of multiple inheritance. Important: The other class must also inherit virtually from CWidget!

Callbacks for widget actions can generally be defined in different ways:

  1. By overriding a virtual method named 'On<action> ()' (C++ style).
  2. By providing a callback function (C style) using a 'SetCb<action> ()' method. The user may supply a typeless pointer to some user-defined data.
  3. By defining a trampoline to an arbitrary method of another class. Trampolines are defined by macros named <widget>_TRAMPOLINE().
Collaboration diagram for Widgets:

Modules

 Extensions
 Widget Extensions.
 
 Button
 Push-button widgets.
 
 Listbox
 Listbox widget.
 
 Menu
 Menu widget and function.
 
 Message Box
 Message box widget and functions.
 
 Input Line
 Input line widget.
 
 Slider
 Horizontal or vertical slider.