Direct calls to the SftBox DLLs are used to communicate with the combo box control for maximum efficiency.
The class CSftBox defines all necessary functions to communicate with the combo box control.
The API Reference section lists C and C++ macros and functions. They are sorted alphabetically, but leading SftBox_, SftBox_Get and SftBox_Set text is not considered. E.g., when looking up the function SftBox_GetCurSel, look for topic CurSel, the leading SftBox_Get is dropped.
| Name | Description |
|---|---|
| LPFNSFTBOX_VGETITEM | Defines the type of the virtual data source callback used by SftBox/DLL to retrieve information about one item as it is needed by the combo box control. |
| LPFNSFTBOX_VRELEASEITEM | Defines the type of the virtual data source callback called by SftBox/DLL to release information previously returned by the LPFNSFTBOX_VGETITEM callback. |
| NM_SFTBOX_CHAR | The NM_SFTBOX_CHAR structure is sent to the parent window with a WM_NOTIFY message (notification code NM_SFTBOX_CHAR_CODE) when a character is typed while the combo box control has the input focus. |
| NM_SFTBOX_KEYDOWN | The NM_SFTBOX_KEYDOWN structure is sent to the parent window with a WM_NOTIFY message (notification code NM_SFTBOX_KEYDOWN_CODE) when a key is pressed while the combo box control has the input focus. |
| NM_SFTBOX_KEYUP | The NM_SFTBOX_KEYUP structure is sent to the parent window with a WM_NOTIFY message (notification code NM_SFTBOX_KEYUP_CODE) when a key is released while the combo box control has the input focus. |
| SFT_PICTURE | Used to describe a picture component (a bitmap, icon or ImageList image, etc.). |
| SFTBOX_CELL | The SFTBOX_CELL structure is used with GetCellInfo and SetCellInfo to retrieve and set cell attributes and as part of the SFTBOX_ITEM structure (for a virtual data source). |
| SFTBOX_CELLINFOPARM | The SFTBOX_CELLINFOPARM structure is used as parameter for GetCellInfo and SetCellInfo to retrieve and set cell attributes. |
| SFTBOX_CLASS | The SFTBOX_CLASS preprocessor symbol defines the window class name of a combo box control. |
| SFTBOX_COLORS | The SFTBOX_COLORS structure is used with GetCtlColors and SetCtlColors to retrieve and set a combo box control's color attributes. |
| SFTBOX_COLUMN | The SFTBOX_COLUMN structure is used with GetColumns and SetColumns to retrieve and set column attributes. |
| SFTBOX_CONTROL | The SFTBOX_CONTROL structure is used with GetControlInfo and SetControlInfo to retrieve and set a combo box control's attributes. |
| SFTBOX_DELETEPARM | The SFTBOX_DELETEPARM structure is used as parameter for SetDeleteCallback to define an application-specific deletion callback routine, which is called whenever an item is removed from the combo box control. |
| SFTBOX_DELETEPROC | Defines the type of a user-supplied callback routine, called by SftBox/DLL whenever an item is removed from the combo box control. |
| SFTBOX_DRAGINFO | The SFTBOX_DRAGINFO structure is used during drag & drop operations and can be retrieved using GetDragInfo. |
| SFTBOX_DWORD_PTR | Defines a type large enough to hold a DWORD or a pointer value. |
| SFTBOX_ID | Defines the type of an item ID. |
| SFTBOX_ITEM | The SFTBOX_ITEM structure is used by the callback function LPFNSFTBOX_VGETITEM to return the requested item information to SftBox/DLL when a virtual data source is used. |
| SFTBOX_MAXLEVELS | The SFTBOX_MAXLEVELS preprocessor symbol defines the highest item level supported. |
| SFTBOX_NOCOLOR | The SFTBOX_NOCOLOR preprocessor symbol is used to indicate that the default color should be used. |
| SFTBOX_ROW | The SFTBOX_ROW structure is used with GetRowInfo and SetRowInfo to retrieve and set row header attributes and as part of the SFTBOX_ITEM structure (for a virtual data source). |
| SFTBOX_ROWINFOPARM | The SFTBOX_ROWINFOPARM structure is used as parameter for GetRowInfo and SetRowInfo to retrieve and set row header attributes. |
| SFTBOX_SORTPROC | Defines the type of a user-supplied callback routine, called by SftBox/DLL to compare two items while sorting items using SortItems. |
| SFTBOX_SORTPROCEX | Defines the type of a user-supplied callback routine, called by SftBox/DLL to compare two items while sorting items using SortItemsEx. |
| SFTBOX_STATIC | The SFTBOX_STATIC preprocessor symbol selects static linking of SftBox/DLL to an application. |
| SFTBOX_TOOLTIPSPARM | The SFTBOX_TOOLTIPSPARM structure is used as parameter for SetToolTipsCallback, to define an application-specific ToolTips callback routine, which can define the ToolTip text when a ToolTip or ScrollTip is to be displayed. |
| SFTBOX_TOOLTIPSPROC | Defines the type of a user-supplied callback routine, called by SftBox/DLL to allow an application to define the text shown when a ToolTip or ScrollTip is about to be displayed. |
| SFTBOX_VIRTUALDEF | The SFTBOX_VIRTUALDEF structure is used by VirtualInitialize to use the combo box control in virtual mode and to define the virtual data source. |
| Name | Description |
|---|---|
| AddString | Adds a new item to a combo box control. The new item is added as the last item at level 0. |
| Buttons | Registers the size and sets the images used for expand/collapse buttons. |
| CalcCellFromPoint | Calculates the item index and column number given a point in combo box control client area coordinates. |
| CalcIndexFromPoint | Calculates the item index number given a point in combo box control client area coordinates. |
| CalcOptimalColumnWidth | Calculates a column's optimal width so text and pictures are not clipped. |
| CalcOptimalRowHeaderWidth | Calculates the optimal width for row headers so text and pictures are not clipped. |
| CaretColumn | Returns the column where a mouse button was last clicked. |
| CellInfo | Defines a cell's attributes. |
| CellRect | Returns a cell's location. |
| Clear | Deletes the selected text in the edit control portion, or removes the selection of a dropdown list combo box. |
| ColHeaderFont | Defines the font used for column header text display. |
| Collapse | Collapses a parent item. |
| Columns | Defines the number of columns and column attributes. |
| ControlInfo | Defines the combo box control's attributes. |
| Copy | Copies text to the clipboard. |
| CopyItem | Copies an item to a new position. |
| Count | Returns the number of items in the combo box control. |
| Create | Creates a combo box control window and attaches it to the CSftBox object. |
| CrossColumnResize | Defines whether multiple columns can be resized during one column resizing operation. |
| CSftBox Constructor / Destructor | Standard constructor and destructor. |
| CtlColors | Defines the combo box control's color attributes. |
| CurSel | Defines the index of the selected item. |
| CustomCode | Defines optional product customization. |
| Cut | Copies text to the clipboard and removes it from the combo box control. |
| DarkMode | Defines whether the combo box control is rendered using a dark color palette. |
| DeleteCallback | Defines a deletion callback routine, called when items are deleted. |
| DeleteDependents | Deletes an item's dependent items. |
| DeleteString | Deletes an item. |
| Dependent | Returns dependent item information for a parent item. |
| DependentCount | Returns the number of dependents for a parent item. |
| DisableNoScroll | Defines the scroll bar handling status. |
| DisplayColumn | Returns the display column number given a real column number. |
| DPI | Returns the effective DPI for the monitor the combo box control is currently displayed on. |
| DragInfo | Returns drag & drop operation information in a SFTBOX_DRAGINFO structure. |
| DragType | Defines the portions of the combo box control where a drag & drop operation can start. |
| DrawSelectionOutline | Draws a selection outline. |
| DropDownButtonDroppedPicture | Defines the picture displayed on the dropdown button while the dropdown portion is shown. |
| DropDownButtonPicture | Defines the picture displayed on the dropdown button. |
| DropDownButtonRect | Returns the location of the dropdown button. |
| DropDownButtonStyle | Defines the dropdown button's display style. |
| DropDownOptimalWidth | Defines whether the dropdown portion is sized to its optimal width. |
| DropDownPosition | Defines whether the dropdown portion is shown below or above the combo box. |
| DropHighlight | Defines the current drag & drop target location. |
| DropHighlightStyle | Defines the display attribute of the current drag & drop target item. |
| DroppedControlRect | Returns the location of the dropdown portion. |
| DroppedHeight | Defines the height of the dropdown portion. |
| DroppedState | Returns whether the dropdown portion is currently shown. |
| DroppedWidth | Defines the width of the dropdown portion. |
| EditAlign | Defines the text alignment in the edit control portion. |
| EditCtlFont | Defines the font used in the edit control portion. |
| EditSearchColumn | Defines the column used for searching and for the text shown in the edit control portion. |
| EditSearchMode | Defines how the combo box control searches for a matching item as the user types. |
| EditSel | Defines the selected text range in the edit control portion. |
| EnableSortIndicators | Enables sort indicators in column headers. |
| Expand | Expands a parent item. |
| ExpandCollapseIndex | Returns the zero-based index of the item to expand/collapse. |
| ExtendedUI | Defines whether the extended user interface is used. |
| FindItem | Searches item data. |
| FindString | Searches a string. |
| FindStringEx | Searches cells for a string. |
| FindStringExact | Searches a string (exact match). |
| FirstDisplayColumn | Returns the index of the first displayed column. |
| FlybyHighlight | Defines whether the item under the mouse cursor is highlighted in the dropdown portion. |
| Fonts | Adds the names of the available fonts to the combo box control. |
| FontSizes | Adds the available sizes of a font to the combo box control. |
| FontStyles | Adds the available styles of a font to the combo box control. |
| FreeGDIPlusImageLoadedFromFile | Deletes a GDI+ image obtained using LoadGDIPlusImageFromFile. |
| FreeGDIPlusImageLoadedFromResource | Deletes a GDI+ image obtained using LoadGDIPlusImageFromResource. |
| GDIPlusAvailable | Returns whether GDI+ support is available. |
| GridStyle | Defines the grid line display style. |
| Header | Defines a column's header text. |
| HeaderButton | Defines the column number of the currently pressed column header button. |
| HeaderLength | Returns the length of a column's header text. |
| HeaderRect | Returns the dimensions of the column header area. |
| HeaderStyle | Defines the column header display style. |
| HighContrastMode | Defines whether the combo box control honors the Windows High Contrast accessibility setting. |
| HorizontalExtent | Defines the horizontal extent (in pixels) of the displayable area. |
| HorizontalOffset | Defines the current horizontal offset (in pixels) of the displayed area. |
| HoverButton | Defines whether the dropdown button changes its appearance when the mouse cursor is located on the button. |
| HWNDDropDown | Returns the window handle of the dropdown portion. |
| HWNDDropDownButton | Returns the window handle of the dropdown button. |
| HWNDEdit | Returns the window handle of the edit control portion. |
| ImageScaling | Defines how images drawn by the combo box control are scaled relative to the current monitor DPI. |
| Indentation | Defines the indentation (in pixels) for item levels. |
| InheritBgColor | Defines whether the area to the left of the first cell inherits the cell's background color. |
| InsertString | Inserts a new item using a string. |
| ItemBitmap | Defines an item's item picture using a bitmap handle. |
| ItemData | Defines an item's application-specific value. |
| ItemExpand | Defines an item's expand status. |
| ItemExpandable | Defines whether an item is expandable. |
| ItemHeight | Returns an item's height (in pixels). |
| ItemHeightMinMax | Defines an item's minimum and maximum height (in pixels). |
| ItemID | Returns an item's ID. |
| ItemIndex | Returns an item's index given an item ID. |
| ItemLabel | Defines an item's label picture using a bitmap handle. |
| ItemLabelPicture | Defines an item's label picture. |
| ItemLevel | Defines an item's level number. |
| ItemLines | Defines the number of text lines used for item height calculation. |
| ItemPicture | Defines an item's item picture. |
| ItemRect | Returns an item's location in client area coordinates. |
| ItemShown | Defines an item's visibility status. |
| ItemsShown | Returns the number of items displayable in the dropdown portion, including partial items. |
| ItemStatus | Defines an item's enabled/disabled status. |
| LimitText | Limits the number of characters the user can enter in the edit control portion. |
| LoadGDIPlusImageFromFile | Loads a GDI+ image from a file. |
| LoadGDIPlusImageFromResource | Loads a GDI+ image from an application's or DLL's resources. |
| Locale | Defines the locale of the combo box control. |
| MakeColumnOptimal | Sets the optimal column width so that the text and pictures of all items can be displayed without being clipped horizontally. |
| MakeColumnVisible | Scrolls the specified column into view horizontally so that it is displayed in the combo box control. |
| MakeRowHeaderOptimal | Sets the optimal row header width so that the text and pictures of all row headers can be displayed. |
| MakeRowVisible | Scrolls the specified item into view vertically so that it is displayed in the dropdown portion. |
| MoveItem | Moves an item to a new position. |
| NextShown | Returns the next visible item. |
| NoFocusStyle | Defines the display style of the selected item when the combo box control does not have the input focus. |
| OpenEnded | Defines whether the last column is open-ended. |
| OverheadWidth | Returns the width of the area added to the first column for hierarchical graphics components. |
| Parent | Returns an item's parent index. |
| Paste | Inserts the clipboard contents in the edit control portion. |
| Pictures | Registers the size and sets the default item pictures used for all items. |
| PixelScaling | Defines how caller-supplied pixel dimensions (column widths, indentation, etc.) are interpreted relative to the current monitor DPI. |
| PrevShown | Returns the previous visible item. |
| ProcessMessage | Defines whether a mouse click that hides the dropdown portion is also processed by the window under the mouse cursor. |
| ReadOnly | Defines whether the edit control portion is read-only. |
| RealColumn | Returns the real column number given a display column number. |
| RecalcHorizontalExtent | Recalculates the optimal horizontal scrolling extent. |
| RegisterApp | Registers an application with SftBox/DLL. |
| ReorderColumns | Defines whether columns can be reordered using column drag & drop. |
| ResetContent | Removes all items from the combo box control. |
| ResizeColumn | Returns the column number of the column being resized. |
| ResizeHeader | Defines whether column headers are resizable by the user. |
| RollUpDelayed | Hides the dropdown portion after the specified time. |
| RollupOnChange | Defines whether the dropdown portion is hidden when items are added or removed. |
| RowColBitmap | Defines the picture displayed in the row/column header. |
| RowColBitmapStyle | Defines the position of the picture displayed in the row/column header. |
| RowColHeaderButton | Defines whether the row/column header button is currently down (pressed). |
| RowColHeaderRect | Returns the dimensions of the row/column header area. |
| RowColHeaderStyle | Defines the position of the text displayed in the row/column header. |
| RowColPicture | Defines the picture displayed in the row/column header. |
| RowColText | Defines the row/column header text. |
| RowColTextLength | Returns the row/column header text length. |
| RowHeaderFont | Defines the font used for row header text display. |
| RowHeaderLines | Defines the number of text lines used for row header height calculation. |
| RowHeaderRect | Returns the dimensions of the row header area. |
| RowHeaderStyle | Defines the position of text displayed in the row headers. |
| RowHeaderWidth | Defines the width of the row header area. |
| RowInfo | Defines an item's row header attributes. |
| RowText | Defines an item's row header text. |
| RowTextLength | Returns an item's row header text length. |
| ScrollTips | Defines whether ScrollTips are displayed during vertical scrolling. |
| SelectionStyle | Defines the display style of the selected item. |
| SelectString | Searches a string and selects the matching item. |
| SelectStringExact | Searches a string and selects the exactly matching item. |
| SelText | Defines the selected text in the edit control portion. |
| SelTextLength | Returns the length of the selected text in the edit control portion. |
| Show3D | Defines the current display method used for items. |
| ShowBitmaps | Returns a value indicating the presence of item pictures. |
| ShowButton0 | Defines the presence of level 0 expand/collapse buttons. |
| ShowButtons | Defines the presence of expand/collapse buttons (other than level 0). |
| ShowDropDown | Shows or hides the dropdown portion. |
| ShowGrid | Defines the presence of grid lines. |
| ShowHeader | Defines the presence and display style of column headers. |
| ShowHeaderDropDown | Defines the presence of column headers in the dropdown portion. |
| ShowHeaderMain | Defines the presence of column headers in the static portion. |
| ShowLabels | Returns the presence of label pictures. |
| ShowResizer | Defines whether the dropdown portion can be resized by the user. |
| ShowRowColHeaderButton | Defines the row/column header's display style. |
| ShowRowHeader | Defines the row header display style. |
| ShowTreeLines | Defines the presence of tree lines. |
| ShowTruncated | Defines whether text is clipped or truncated using trailing "...". |
| Sibling | Returns an item's sibling information. |
| SizeBox | Defines whether a size box is shown in the lower-right corner of the dropdown portion so the user can resize the dropdown portion by dragging it. |
| SortItems | Sorts items. |
| SortItemsEx | Sorts items using cell and item information. |
| Text | Defines an item's cell text. |
| TextLength | Returns the length of an item's cell text. |
| ToolTipsCallback | Defines an application supplied callback function, which can define the ToolTip text when a ToolTip or ScrollTip is to be displayed. |
| TopIndex | Defines the index number of the item shown at the top of the dropdown portion. |
| TopParent | Returns the highest level parent index number for an item. |
| TreeLineStyle | Defines the display style of tree lines. |
| UnregisterApp | Unregisters an application from SftBox/DLL. |
| UpdateCaretExpandCollapse | Defines whether the current item is updated when the expand/collapse buttons are used. |
| UserData | Defines the combo box control's application-specific value. |
| UseSmoothScroll | Defines whether smooth scrolling is used. |
| UseThemes | Defines whether the control can use Windows themes. |
| VAlign | Defines the vertical alignment of tree lines, label pictures and item pictures. |
| VirtualCount | Defines the number of items when using a virtual data source. |
| VirtualFlush | Discards cached item information of a combo box control using a virtual data source. |
| VirtualInitialize | Initializes a combo box control for virtual mode and for use with a virtual data source. |
| VirtualItemChanged | Notifies a combo box control using a virtual data source that items have been changed. |