> For the complete documentation index, see [llms.txt](https://docs.iceteagroup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iceteagroup.com/general/framework/features/visual-toolchest.md).

# Visual Toolchest

All *Visual Toolchest* functions are defined in the *PPJ.Runtime.Vis* class as static methods. The names are all unchanged, with the *Vis* prefix being the name of the class: VisStrPad() is Vis.StrPad(). Also all the supported Visual Toolchest controls are declared in *PPJ.Runtime.Vis*. The names of the controls have been normalized to *Vis*\<Name>. Ice Porter changes the names automatically while porting: cColorCombBox is ported to VisColorComboBox.

All Visual Toolchest controls are directly derived from either PPJ controls (which are directly derived from .NET controls) or from .NET controls. Extended controls like the calendar or the outline control in the Visual Toolchest library are implemented extending the equivalent .NET controls, which are implemented in .NET as wrapper to the common controls library.

## Unsupported functions

There are no unsupported public functions for the *Visual Toolchest* library.&#x20;

However some SAL code may use undocumented functions that were not intended to be used directly and are not supported in the PPJ Framework.

## Unsupported controls

All *Visual Toolchest* controls are supported.&#x20;

However some extended controls may behave a bit differently or may have some limitations because we use the standard .NET implementation of common controls. The following table shows the equivalence between custom VT controls and Windows common controls:

| Visual Toolchest control | Equivalent .NET control (from Windows Common Controls) |
| ------------------------ | ------------------------------------------------------ |
| cRichEdit                | RichTextBox                                            |
| cOutlineListBox          | TreeView                                               |
| cDesktopListBox          | TreeView                                               |
| cDirListBox              | TreeView                                               |
| cDirTreeListBox          | TreeView                                               |
| cListView                | ListView                                               |
| cCalendar                | MonthCalendar                                          |
| cCalendarDropDown        | DateTimePicker                                         |

## Unsupported styles

Some Visual Toolchest controls support a number of style constants that alter the behavior of the control. Most of the styles have a direct correspondence to Windows Common Controls styles and are supported in the PPJ Framework. The table below lists the style correspondence.

| Control  | Supported VT styles                                                                                                                                       | Equivalent property                                                                                                                                  |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| TreeView | <p>LBS\_KillFocusNoSelect</p><p>LBS\_ShowHorzScrollBar</p><p>LBS\_ShowNoTree</p><p>LBS\_ShowSelectText</p><p>LBS\_Explorer</p><p>LBS\_DisableNoScroll</p> | <p>HideSelection</p><p>HorizontalScrollbar (only for VisOutlineListBox)</p><p>ShowLines</p><p>FullRowSelect</p><p>ShowPlusMinus</p><p>Scrollable</p> |
| ComboBox | None                                                                                                                                                      | None                                                                                                                                                 |
| ListBox  | LBS\_NoAutoResize                                                                                                                                         | IntegralHeight                                                                                                                                       |

&#x20;

{% hint style="success" %}
The original SAL application may try to apply VT style LBS\_VisExtensions to controls that are not derived from VT classes. This is not supported in the PPJ Framework because it's an internal feature of the VT library used to subclass the control. When reading the styles of a VT derived class, the LBS\_VisExtensions value is automatically added by the PPJ Framework to the return value.
{% endhint %}