12 User Interface Components

User Interface components should not be confused with the TUI_Component object which is the interface between TComponent descendants and the main application. User Interface components are Components which provide a visual interface for the user. They operate in one of two modes: stand-alone and embedded. When embedded, user interface components are shown inside the application (assuming the application supports that). In Stand-alone mode the component shows apart from the application. Functions unique to User Interfaces are accessed via the TUser_Interface object, provided via the TComponent.User_Interface method.

The TUser_Interface class has the following methods:

boolean Get_Hidden()

Returns True if the component is currently visible.

void Set_Hidden( boolean Value )

Sets the component to hidden (if Value is true) or visible (if Value is false).

integer Get_Parent_Window()

Returns the handle of the component's parent window.

void Set_Parent_Window( integer Value )

Sets the component's parent to the window with the passed handle.

string Get_Caption()

Returns the caption of the component.

void Set_Caption( string Value )

Sets the caption of the component.

void Set_Size( integer Height, integer Width )

Sets the visual size of the component to the passed height and width, in pixels.

integer Optimal_Height()

Returns the optimal height of the component, in pixels.

integer Optimal_Width()

Returns the optimal width of the component, in pixels.

integer Version()

Returns the version of the CEF specification that the object adheres to. This is the major.minor version times 10. For instance, a value of 20 indicates version 2.0.

The following methods are supported in components conforming to version 2.4, or later, of the specification.

void Initialize()

Initializes the component. This should only be called once.