# SftBox/DLL 6.0 — Guide > SftBox/DLL is a DLL-based combo box control for the Windows™ operating system, offering multi-column, hierarchical dropdown lists with pictures, column headers, autocompletion and font selection. Index of the SftBox/DLL 6.0 guide, which is split into 8 files in reading order. Each entry links one file and lists its topics; read only the files you need. Online documentation: https://softelvdm.com/Documentation/SftBox%20DLL%206%200 API reference (index of the reference files): https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-reference.txt ## Introduction https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-1.txt - SftBox/DLL - Combo Box Control: SftBox/DLL is a DLL-based combo box control for the Windows™ operating system, offering multi-column, hierarchical dropdown lists with pictures, column headers, autocompletion and font selection. - Installing SftBox/DLL: When you are ready to install SftBox/DLL: ## Features (1 of 5) https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-2.txt - Components: A combo box control is composed of several parts. - Basic Styles: SftBox/DLL offers three basic combo box styles, matching the styles of the standard Windows combo box. - Static Portion: A dropdown list combo box (SFTBOXSTYLE_DROPDOWNLIST) uses a static portion to display the selected item. - Edit Control Portion: A simple combo box (SFTBOXSTYLE_SIMPLE) and a dropdown combo box (SFTBOXSTYLE_DROPDOWN) use an edit control to display the selected item and to accept text typed by the user. - Dropdown Portion: The dropdown portion of a combo box control is the list of items the user can select from. - Dropdown Button: A dropdown combo box and a dropdown list combo box have a dropdown button, which the user clicks to show or hide the dropdown portion. - Sizing the Dropdown Portion: The dropdown portion of a dropdown combo box or dropdown list combo box can be resized by the user if a sizing box is available. - Columns: A SftBox/DLL combo box control can display one or more columns. ## Features (2 of 5) https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-3.txt - Column Headers: A combo box control can display column headers with a title for each column. - Column Resizing: A combo box control can allow the user to resize columns. - Column Reordering: A combo box control can allow the user to reorder columns by dragging a column header and dropping it at a new position. - Display vs. Real Columns: When users are allowed to reorder columns (see Column Reordering), they may see the columns in an order other than the order in which the application defined them. - Row Headers: A combo box control can display a row header for each item, an area at the beginning of the item that is not part of any column. - Items: An item (also called row) is one entry in the list of a combo box control. - Expanding and Collapsing Items: If the items of a combo box control form a hierarchy (see item hierarchy), parent items can be expanded and collapsed. - Fixed / Variable Height Items: A combo box control determines the height of its items in one of two ways. - Multi-Line Cell Text: The cell text in a combo box control can consist of several text lines. - Cell Merging: In a combo box control with multiple columns, the contents of a cell can merge into the adjacent cell on the right, including the cell colors, font and picture. ## Features (3 of 5) https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-4.txt - Progress Bar: Each cell of a combo box control can display a simple progress bar. - Pictures: A combo box control can display pictures in many locations. - Selection: A combo box control has one selected item, or no selected item at all. - Flyby Highlighting: Flyby highlighting gives the user immediate feedback about the item the mouse cursor is located on. - Searching and Autocomplete: A combo box control can search for an item as the user types. - Sorting: The items of a combo box control are displayed in the order in which they were added. - Scrolling: The dropdown portion of a combo box control can be scrolled vertically if it contains more items than it can display and horizontally if its items are wider than the dropdown portion. - ToolTips: A combo box control can display ToolTips for cells whose contents are only partially visible, explanatory ToolTips with application defined text and ScrollTips while the user scrolls the dropdown portion. ## Features (4 of 5) https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-5.txt - Drag & Drop: A combo box control can be the source of a drag & drop operation. - Context Menu: A context menu (or popup menu) is easily implemented with SftBox/DLL. - Font Selection: SftBox/DLL provides built-in support for combo boxes used to select a font name, a font style and a font point size, as found in a typical font selection dialog. - Virtual Data Source: A combo box control is normally populated by adding items one at a time using AddString or InsertString. - Keyboard & Mouse Interface: This topic describes the keys and mouse actions handled by a combo box control. - GDI+: The combo box control uses GDI+ for features not otherwise available: - Using Themes: A combo box control uses Windows themes (visual styles) by default, so it matches the standard Windows controls of the application. - Dark Mode: SftBox/DLL 6.0 supports dark mode. - High Contrast: Windows High Contrast is an accessibility setting, not a visual preference. - Accessibility (Screen Readers): SftBox/DLL 6.0 ships with built-in Windows UI Automation (UIA) support. ## Features (5 of 5) https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-6.txt - Per-Monitor DPI and Scaling: SftBox/DLL 6.0 is Per-Monitor v2 DPI-aware. - Right-To-Left Reading Support: A combo box control created with the extended window style WS_EX_RIGHT supports right-to-left reading, for languages such as Arabic and Hebrew. ## Programming https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-7.txt - Building Applications: This section describes how to prepare an application using the C or C++ programming language to successfully use SftBox/DLL. - Creating a Dialog Resource: This section describes how to add a combo box control to a dialog using Visual Studio. - Using C: This section describes how to use SftBox/DLL in an application written using the C programming language. - Using C++/MFC: This section describes how to use SftBox/DLL in an application written using C++ and the Microsoft Foundation Class library (MFC). - MFC and Notifications: Notifications can be handled by a combo box control's parent window or directly by the combo box itself (in a derived class). ## Demo Application https://softelvdm.com/Vault/Softelvdm.com/llms/SftBox-DLL-6.0-guide-8.txt - Demo Application: During the installation of SftBox/DLL, an icon for the demo application "Demo" (SftBoxDLLDemo.exe) is installed in the program group SftBox DLL 6.0. - Samples: SftBox/DLL includes sample code for C and C++/MFC. - Colors Sample (C): This sample illustrates two dropdown list combo boxes used to select a color, each item showing a color sample as cell picture. - DataInput Sample (C): This sample illustrates dropdown combo boxes used for data entry. - ItemImages Sample (C): This sample illustrates pictures in dropdown list combo boxes, using the small icons Windows provides. - DragDrop Sample (C): This sample illustrates drag & drop between two simple combo boxes. - Fonts Sample (C): This sample illustrates font selection using three combo boxes for font names, font styles and font sizes, which are added by SftBox/DLL using the Fonts, FontStyles and FontSizes functions, for the display or a printer. - Colors Sample (C++/MFC): This sample illustrates two dropdown list combo boxes used to select a color, each item showing a color sample as cell picture, hosted in an MFC dialog through CSftBox and DDX_Control. - DataInput Sample (C++/MFC): This sample illustrates dropdown combo boxes used for data entry, hosted in an MFC dialog through CSftBox. - ItemImages Sample (C++/MFC): This sample illustrates pictures in dropdown list combo boxes, hosted in an MFC dialog through CSftBox, using the small icons Windows provides. - DragDrop Sample (C++/MFC): This sample illustrates drag & drop between two simple combo boxes, hosted in an MFC dialog through CSftBox. - Fonts Sample (C++/MFC): This sample illustrates font selection using three combo boxes for font names, font styles and font sizes, hosted in an MFC dialog through CSftBox. - SftBox/DLL Wizard: During the installation of SftBox/DLL, an icon for the application "Wizard" is installed in the program group SftBox DLL 6.0. - SftBox/DLL Wizard Help: The SftBox/DLL Wizard is used to define a new combo box control or to edit an existing definition. - Class Info - Class Information: Based on the information entered on this page, the generated source code is adjusted to reflect the following settings: - Events - Event Viewer: The WM_COMMAND notifications sent by the sample combo box are displayed in a list as they occur, with the item, cell or column involved where it applies. - Values - API Return Values: This page displays many commonly used API return values. - C, C++/MFC - Generated Source Code: The source code generated using the C or C++/MFC tabs can be used to implement a combo box in an application. - Distributing the Dlls: Distributing the DLLs included with SftBox DLL 6.0 is only possible in accordance with the licensing agreement. - Technical Support: New major versions and product maintenance are available with an active support subscription.