HeaderPane
Main
Hide
Share Link
Print

C/C++ API (By Category)

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 following function groups are listed in detail:

AccessibilityDark mode and High Contrast
ApplicationApplication initialization and termination
AttributesGeneral combo box control attributes
Callback RoutinesApplication-defined callback routines
Columns and Column HeadersColumn and column header attributes
DPI and ScalingPer-Monitor DPI awareness and image / pixel scaling
Drag & DropDrag & drop support functions
Dropdown ButtonDropdown button attributes
Dropdown PortionDropdown portion attributes and manipulation
Edit Control PortionEdit control portion attributes and manipulation
Font SelectionFont name, style and size combo boxes
Item AttributesItem and cell attributes
Item Hit TestingHit testing
ItemsItem manipulation
Positioning & ResizingItem positioning and resizing
RelationshipsRetrieving parent/child relationship information
Row HeaderRow header attributes
Row/Column HeaderRow/column header attributes
ScrollingScrolling manipulation
SelectionThe currently selected item
SortingSorting items
Virtual ModeUsing a virtual data source

Accessibility

DarkModeDefines whether the combo box control is rendered using a dark color palette.
HighContrastModeDefines whether the combo box control honors the Windows High Contrast accessibility setting.

Application

FreeGDIPlusImageLoadedFromFileDeletes a GDI+ image obtained using LoadGDIPlusImageFromFile.
FreeGDIPlusImageLoadedFromResourceDeletes a GDI+ image obtained using LoadGDIPlusImageFromResource.
GDIPlusAvailableReturns whether GDI+ support is available.
LoadGDIPlusImageFromFileLoads a GDI+ image from a file.
LoadGDIPlusImageFromResourceLoads a GDI+ image from an application's or DLL's resources.
RegisterAppRegisters an application with SftBox/DLL.
UnregisterAppUnregisters an application from SftBox/DLL.

Attributes

ButtonsRegisters the size and sets the images used for expand/collapse buttons.
ControlInfoDefines the combo box control's attributes.
CreateCreates a combo box control window and attaches it to the CSftBox object.
CSftBox Constructor / DestructorStandard constructor and destructor.
CtlColorsDefines the combo box control's color attributes.
CustomCodeDefines optional product customization.
FlybyHighlightDefines whether the item under the mouse cursor is highlighted in the dropdown portion.
GridStyleDefines the grid line display style.
IndentationDefines the indentation (in pixels) for item levels.
InheritBgColorDefines whether the area to the left of the first cell inherits the cell's background color.
ItemLinesDefines the number of text lines used for item height calculation.
ItemsShownReturns the number of items displayable in the dropdown portion, including partial items.
LocaleDefines the locale of the combo box control.
NoFocusStyleDefines the display style of the selected item when the combo box control does not have the input focus.
PicturesRegisters the size and sets the default item pictures used for all items.
ProcessMessageDefines whether a mouse click that hides the dropdown portion is also processed by the window under the mouse cursor.
ScrollTipsDefines whether ScrollTips are displayed during vertical scrolling.
Show3DDefines the current display method used for items.
ShowBitmapsReturns a value indicating the presence of item pictures.
ShowButton0Defines the presence of level 0 expand/collapse buttons.
ShowButtonsDefines the presence of expand/collapse buttons (other than level 0).
ShowGridDefines the presence of grid lines.
ShowLabelsReturns the presence of label pictures.
ShowTreeLinesDefines the presence of tree lines.
ShowTruncatedDefines whether text is clipped or truncated using trailing "...".
TreeLineStyleDefines the display style of tree lines.
UpdateCaretExpandCollapseDefines whether the current item is updated when the expand/collapse buttons are used.
UserDataDefines the combo box control's application-specific value.
UseSmoothScrollDefines whether smooth scrolling is used.
UseThemesDefines whether the control can use Windows themes.
VAlignDefines the vertical alignment of tree lines, label pictures and item pictures.

Callback Routines

DeleteCallbackDefines a deletion callback routine, called when items are deleted.
ToolTipsCallbackDefines an application supplied callback function, which can define the ToolTip text when a ToolTip or ScrollTip is to be displayed.

Columns and Column Headers

ColHeaderFontDefines the font used for column header text display.
ColumnsDefines the number of columns and column attributes.
CrossColumnResizeDefines whether multiple columns can be resized during one column resizing operation.
DisplayColumnReturns the display column number given a real column number.
FirstDisplayColumnReturns the index of the first displayed column.
HeaderDefines a column's header text.
HeaderButtonDefines the column number of the currently pressed column header button.
HeaderLengthReturns the length of a column's header text.
HeaderRectReturns the dimensions of the column header area.
HeaderStyleDefines the column header display style.
OpenEndedDefines whether the last column is open-ended.
OverheadWidthReturns the width of the area added to the first column for hierarchical graphics components.
RealColumnReturns the real column number given a display column number.
ReorderColumnsDefines whether columns can be reordered using column drag & drop.
ResizeColumnReturns the column number of the column being resized.
ResizeHeaderDefines whether column headers are resizable by the user.
ShowHeaderDefines the presence and display style of column headers.
ShowHeaderMainDefines the presence of column headers in the static portion.

DPI and Scaling

DPIReturns the effective DPI for the monitor the combo box control is currently displayed on.
ImageScalingDefines how images drawn by the combo box control are scaled relative to the current monitor DPI.
PixelScalingDefines how caller-supplied pixel dimensions (column widths, indentation, etc.) are interpreted relative to the current monitor DPI.

Drag & Drop

DragInfoReturns drag & drop operation information in a SFTBOX_DRAGINFO structure.
DragTypeDefines the portions of the combo box control where a drag & drop operation can start.
DropHighlightDefines the current drag & drop target location.
DropHighlightStyleDefines the display attribute of the current drag & drop target item.

Dropdown Button

DropDownButtonDroppedPictureDefines the picture displayed on the dropdown button while the dropdown portion is shown.
DropDownButtonPictureDefines the picture displayed on the dropdown button.
DropDownButtonRectReturns the location of the dropdown button.
DropDownButtonStyleDefines the dropdown button's display style.
HoverButtonDefines whether the dropdown button changes its appearance when the mouse cursor is located on the button.
HWNDDropDownButtonReturns the window handle of the dropdown button.

Dropdown Portion

DropDownOptimalWidthDefines whether the dropdown portion is sized to its optimal width.
DropDownPositionDefines whether the dropdown portion is shown below or above the combo box.
DroppedControlRectReturns the location of the dropdown portion.
DroppedHeightDefines the height of the dropdown portion.
DroppedStateReturns whether the dropdown portion is currently shown.
DroppedWidthDefines the width of the dropdown portion.
ExtendedUIDefines whether the extended user interface is used.
HWNDDropDownReturns the window handle of the dropdown portion.
RollUpDelayedHides the dropdown portion after the specified time.
RollupOnChangeDefines whether the dropdown portion is hidden when items are added or removed.
ShowDropDownShows or hides the dropdown portion.
ShowHeaderDropDownDefines the presence of column headers in the dropdown portion.
ShowResizerDefines whether the dropdown portion can be resized by the user.
SizeBoxDefines 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.

Edit Control Portion

ClearDeletes the selected text in the edit control portion, or removes the selection of a dropdown list combo box.
CopyCopies text to the clipboard.
CutCopies text to the clipboard and removes it from the combo box control.
EditAlignDefines the text alignment in the edit control portion.
EditCtlFontDefines the font used in the edit control portion.
EditSearchColumnDefines the column used for searching and for the text shown in the edit control portion.
EditSearchModeDefines how the combo box control searches for a matching item as the user types.
EditSelDefines the selected text range in the edit control portion.
HWNDEditReturns the window handle of the edit control portion.
LimitTextLimits the number of characters the user can enter in the edit control portion.
PasteInserts the clipboard contents in the edit control portion.
ReadOnlyDefines whether the edit control portion is read-only.
SelTextDefines the selected text in the edit control portion.
SelTextLengthReturns the length of the selected text in the edit control portion.

Font Selection

FontsAdds the names of the available fonts to the combo box control.
FontSizesAdds the available sizes of a font to the combo box control.
FontStylesAdds the available styles of a font to the combo box control.

Item Attributes

CellInfoDefines a cell's attributes.
ExpandCollapseIndexReturns the zero-based index of the item to expand/collapse.
ItemBitmapDefines an item's item picture using a bitmap handle.
ItemDataDefines an item's application-specific value.
ItemExpandDefines an item's expand status.
ItemExpandableDefines whether an item is expandable.
ItemHeightReturns an item's height (in pixels).
ItemHeightMinMaxDefines an item's minimum and maximum height (in pixels).
ItemIDReturns an item's ID.
ItemIndexReturns an item's index given an item ID.
ItemLabelDefines an item's label picture using a bitmap handle.
ItemLabelPictureDefines an item's label picture.
ItemLevelDefines an item's level number.
ItemPictureDefines an item's item picture.
ItemRectReturns an item's location in client area coordinates.
ItemShownDefines an item's visibility status.
ItemStatusDefines an item's enabled/disabled status.
TextDefines an item's cell text.
TextLengthReturns the length of an item's cell text.

Item Hit Testing

CalcCellFromPointCalculates the item index and column number given a point in combo box control client area coordinates.
CalcIndexFromPointCalculates the item index number given a point in combo box control client area coordinates.
CellRectReturns a cell's location.

Items

AddStringAdds a new item to a combo box control. The new item is added as the last item at level 0.
CollapseCollapses a parent item.
CopyItemCopies an item to a new position.
CountReturns the number of items in the combo box control.
DeleteDependentsDeletes an item's dependent items.
DeleteStringDeletes an item.
ExpandExpands a parent item.
FindItemSearches item data.
FindStringSearches a string.
FindStringExSearches cells for a string.
FindStringExactSearches a string (exact match).
InsertStringInserts a new item using a string.
MoveItemMoves an item to a new position.
ResetContentRemoves all items from the combo box control.

Positioning & Resizing

CalcOptimalColumnWidthCalculates a column's optimal width so text and pictures are not clipped.
CalcOptimalRowHeaderWidthCalculates the optimal width for row headers so text and pictures are not clipped.
MakeColumnOptimalSets the optimal column width so that the text and pictures of all items can be displayed without being clipped horizontally.
MakeColumnVisibleScrolls the specified column into view horizontally so that it is displayed in the combo box control.
MakeRowHeaderOptimalSets the optimal row header width so that the text and pictures of all row headers can be displayed.
MakeRowVisibleScrolls the specified item into view vertically so that it is displayed in the dropdown portion.
TopIndexDefines the index number of the item shown at the top of the dropdown portion.

Relationships

DependentReturns dependent item information for a parent item.
DependentCountReturns the number of dependents for a parent item.
NextShownReturns the next visible item.
ParentReturns an item's parent index.
PrevShownReturns the previous visible item.
SiblingReturns an item's sibling information.
TopParentReturns the highest level parent index number for an item.

Row Header

RowHeaderFontDefines the font used for row header text display.
RowHeaderLinesDefines the number of text lines used for row header height calculation.
RowHeaderRectReturns the dimensions of the row header area.
RowHeaderStyleDefines the position of text displayed in the row headers.
RowHeaderWidthDefines the width of the row header area.
RowInfoDefines an item's row header attributes.
RowTextDefines an item's row header text.
RowTextLengthReturns an item's row header text length.
ShowRowHeaderDefines the row header display style.

Row/Column Header

RowColBitmapDefines the picture displayed in the row/column header.
RowColBitmapStyleDefines the position of the picture displayed in the row/column header.
RowColHeaderButtonDefines whether the row/column header button is currently down (pressed).
RowColHeaderRectReturns the dimensions of the row/column header area.
RowColHeaderStyleDefines the position of the text displayed in the row/column header.
RowColPictureDefines the picture displayed in the row/column header.
RowColTextDefines the row/column header text.
RowColTextLengthReturns the row/column header text length.
ShowRowColHeaderButtonDefines the row/column header's display style.

Scrolling

DisableNoScrollDefines the scroll bar handling status.
HorizontalExtentDefines the horizontal extent (in pixels) of the displayable area.
HorizontalOffsetDefines the current horizontal offset (in pixels) of the displayed area.
RecalcHorizontalExtentRecalculates the optimal horizontal scrolling extent.

Selection

CaretColumnReturns the column where a mouse button was last clicked.
CurSelDefines the index of the selected item.
DrawSelectionOutlineDraws a selection outline.
SelectionStyleDefines the display style of the selected item.
SelectStringSearches a string and selects the matching item.
SelectStringExactSearches a string and selects the exactly matching item.

Sorting

EnableSortIndicatorsEnables sort indicators in column headers.
SortItemsSorts items.
SortItemsExSorts items using cell and item information.

Virtual Mode

VirtualCountDefines the number of items when using a virtual data source.
VirtualFlushDiscards cached item information of a combo box control using a virtual data source.
VirtualInitializeInitializes a combo box control for virtual mode and for use with a virtual data source.
VirtualItemChangedNotifies a combo box control using a virtual data source that items have been changed.

Last Updated 11/21/2026 - (email)
© 2026 Softel vdm, Inc.