ATF Control Groups - kaisu1986/ATF GitHub Wiki

Table of Contents Control Groups Tab Icons on Centered Controls Topics in this section

Control Groups

The control group is the initial position for a top-level control within the application's main form or dock. All the control group identifiers are listed in the StandardControlGroup enumeration.

You can specify a control's group when:

You create a ControlInfo or ControlDef object, as described in ControlInfo and ControlDef Classes.
You register a control. For more information, see Registering Controls.

Controls that are registered with a control group on the perimeter of the application window (Left, Right, Top, Bottom, Floating) are displayed as docked (pinned) windows that can be unpinned, floated, or hidden. Multiple controls in the same positions are overlapped and tabbed. Palettes, item listers, and property editing controls are most often registered as perimeter controls.

Centered controls (Center and CenterPermanent) are displayed in the middle of the application as overlapping tabbed windows. Even single center controls are displayed with a tab.

All controls except for those registered as CenterPermanent can be undocked, unpinned, or hidden by the user at run time. Controls registered as CenterPermanent are anchored in place and cannot be moved, hidden, or closed.

This example creates a ControlInfo object for a control in the left position (StandardControlGroup.Left):

ControlInfo controlInfo = new ControlInfo("Items", "Property Editing Sample List", StandardControlGroup.Left);

Controls are given tabs if they are centered (Center or CenterPermanent) or if there are multiple controls docked in the same perimeter position. By default, the tab is given a text label (the Name property for the control, if specified, or "(Untitled)").

Tab Icons on Centered Controls

You can also define an image icon for a control, which is displayed on the control's tab. The icon appears on the tab, in addition to the name.

Use the optional image argument in ControlInfo, ControlDef, or RegisterControl() to add an icon to a tab. The icon is a System.Drawing.Image object.

You can use your own image or get a standard image with one of the ResourceUtil.GetImage() methods.

Topics in this section

Controls in ATF

Using Controls in ATF: Overview of using controls in ATF.
ControlInfo and ControlDef Classes: Description of the ControlInfo (WinForms) and ControlDef (WPF) classes that describe a control's appearance and location in the UI.
ATF Control Groups: About control groups, which provide an initial position for a top-level control.
Registering Controls: How to register controls with the ControlHostService component.
Creating Control Clients: Creating a control client that specifies the control's behavior, if any, when the control gains or loses focus, or is closed.
Using WinForms Controls in WPF: How to use WinForms-based component controls and dialogs in a WPF based application.
Adaptable Controls: Discussion of the AdaptableControl class, which provides a control with adapters.
ATF Custom Controls: Overview of the custom controls ATF provides.
ATF Custom Dialogs: Overview of the standard dialogs in ATF.

ATF Control Groups - kaisu1986/ATF GitHub Wiki

Table of Contents

Control Groups

Tab Icons on Centered Controls

Topics in this section

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️