C/C++ API


	C/C++ API	Softel vdm, Inc.

An application communicates with the SftTabs/DLL tab control by sending messages using the Windows SendMessage function. To simplify the process, SftTabs/DLL offers predefined macros for messages. This eliminates the casting of parameters and the use of SendMessage.

Definitions and Structures

Name	Description
SFTTABS_CLASS	Defines the SftTabs/DLL control window class name.
SFTTABS_COLORS	Used with GetCtlColors and SetCtlColors to retrieve and set a tab control's color attributes.
SFTTABS_CONTROL	Used to describe a tab control's layout and attributes.
SFTTABS_DRAWBACKGROUNDPROC	Defines the type of a user-supplied drawing callback routine called by SftTabs/DLL, which paints the tab page background.
SFTTABS_DRAWINFO	Passed to an application defined callback routine which can calculate the size or paint the tab labels.
SFTTABS_DRAWPROCPARM	Used as a parameter for SetDrawTabCallback to define an application-specific drawing callback routine, which paints the tab labels.
SFTTABS_DRAWTABPROC	Defines the type of a user-supplied drawing callback routine called by SftTabs/DLL, which paints the tab labels.
SFTTABS_DWORD_PTR	Represents a type large enough to hold a DWORD or pointer value.
SFTTABS_GRAPH	Describes a tab's picture component and its location.
SFTTABS_LONG_PTR	Represents a type large enough to hold a long or pointer value.
SFTTABS_MAXROWS	Defines the maximum number of tab rows.
SFTTABS_MAXTABS	Defines the maximum number of tabs per tab control.
SFTTABS_NOCOLOR	Indicates that the default color should be used.
SFTTABS_STATIC	Defines static linking of SftTabs/DLL to an application.
SFTTABS_STYLETABLEA	Describes each available tab style.
SFTTABS_TAB	Describes one tab label, including its colors, picture and text components.
SFTTABS_TABCALLBACK	Defines the callback function associated with a tab. This callback routine is called by SftTabs/DLL to create and destroy the page associated with a tab.

Messages and Functions

Name	Description
SftTabs_ActivatePage	Activates a page.
SftTabs_AddTab	Adds a new tab to a tab control. The new tab will be added as the last tab.
SftTabs_AdjustClientRect	Calculates a tab control size which will provide a client area of the given size.
SftTabs_ClosePossible	The parent window of a tab control calls the SftTabs_ClosePossible function to test if a tabbed dialog or window can be ended.
SftTabs_CopyWindowTitle	Copies the window caption of a window to another window.
SftTabs_DeactivatePage	The parent window of a tab control calls the SftTabs_DeactivatePage function to signal that the current page is no longer the active page.
SftTabs_DeleteTab	Deletes a tab from the tab control.
SftTabs_Destroy	The parent window of a tab control calls SftTabs_Destroy when the parent window is about to be destroyed.
SftTabs_DrawSelectionOutline	Draws a selection outline.
SftTabs_FreeGDIPlusImageLoadedFromResource	Deletes a GDI+ image obtained using SftTabs_LoadGDIPlusImageFromResource.
SftTabs_GetAllowAllInactive	Enables all tabs to become inactive.
SftTabs_GetControlInfo	Retrieves tab control attributes.
SftTabs_GetCount	Retrieves the number of tabs in a tab control.
SftTabs_GetCtlColors	Returns the tab control's color attributes.
SftTabs_GetCurrentTab	Retrieves the index of the currently active tab.
SftTabs_GetEndPageMessage	Retrieves the private message ID sent to a page of a tabbed dialog when the user chooses to switch to another page or to end the tabbed dialog.
SftTabs_GetGDIPlusAvailable	Returns whether GDI+ support is available.
SftTabs_GetNextTab	Retrieves the index of the next tab about to become active.
SftTabs_GetStyleTable	Returns a pointer to the style table. The style table describes all available tab styles, suitable for use by a resource editor.
SftTabs_GetTabControlFromPage	Returns the tab control window handle, given the window handle of a window attached to a tab.
SftTabs_GetTabInfo	Retrieves tab attributes.
SftTabs_GetTabLabel	Retrieves a tab's text.
SftTabs_GetTabLabelLen	Retrieves the length of a tab's text.
SftTabs_GetToolTip	Retrieves a tab's ToolTip text.
SftTabs_GetToolTipLen	Retrieves the length of a tab's ToolTip text.
SftTabs_GetVisibleCount	Retrieves the count of visible tabs.
SftTabs_HandleDialogMessage	The parent dialog window of a tab control and the dialogs used as pages of a tab control call SftTabs_HandleDialogMessage to pass messages on to SftTabs/DLL so they can be processed.
SftTabs_HandleWindowMessage	The parent window of a tab control and the windows or dialogs used as pages of a tab control call SftTabs_HandleWindowMessage to pass messages on to SftTabs/DLL so they can be processed.
SftTabs_HitTest	Determines the tab index of the tab at a given location.
SftTabs_InsertTab	Inserts a new tab at the specified position.
SftTabs_IsHiRes	Returns whether high resolution support is enabled.
SftTabs_IsRegisteredDialog	Determines whether a given dialog is registered with SftTabs/DLL for special tabbed dialog or tabbed window handling, such as accelerator key handling, ESCAPE and TAB key processing, etc.
SftTabs_IsRegisteredWindow	Determines whether a given window is registered with SftTabs/DLL for special tabbed dialog or tabbed window handling, such as accelerator key handling, ESCAPE and TAB key processing, etc.
SftTabs_IsTabControl	Determines whether a given window is a tab control.
SftTabs_IsTabControlWithDialog	Determines whether a given window is a tab control with an attached page.
SftTabs_IsTabControlWithPage	Determines whether a given window is a tab control with an attached page.
SftTabs_LoadGDIPlusImageFromResource	Loads a GDI+ image from an application's or DLL's resources.
SftTabs_PaintBitmap	Paints a bitmap.
SftTabs_PaintTiledBitmap	Paints a bitmap, tiling it if necessary.
SftTabs_QueryChar	Tests if a tab control responds to the specified character, i.e. the character is an accelerator key which the tab control processes.
SftTabs_RegisterApp	Registers the application for use of SftTabs/DLL controls.
SftTabs_RegisterDialog	Registers a dialog containing a tab control.
SftTabs_RegisterWindow	Registers a window containing a tab control.
SftTabs_ResetContent	Removes all tabs from a tab control.
SftTabs_ResizePages	Resizes attached pages when using a frame window.
SftTabs_ScrollTabs	Scrolls tabs in the direction specified.
SftTabs_SetAllowAllInactive	Enables all tabs to become inactive.
SftTabs_SetControlInfo	Sets tab control attributes.
SftTabs_SetCtlColors	Sets the tab control's color attributes.
SftTabs_SetCurrentTab	Makes the specified tab the new active tab.
SftTabs_SetCurrentTabEx	Makes the specified tab the new active tab.
SftTabs_SetDrawTabCallback	Defines a drawing callback routine used to paint tab labels.
SftTabs_SetPageActive	Notifies a tab control that the page attached to the currently active tab has been activated.
SftTabs_SetPageInactive	Notifies a tab control that the page attached to the currently active tab has been deactivated.
SftTabs_SetTabInfo	Sets the tab attributes for the specified tab.
SftTabs_SetTabLabel	Sets a tab's text.
SftTabs_SetToolTip	Sets a tab's ToolTip text.
SftTabs_SetVersion	Sets the SftTabs/DLL version an application requires.
SftTabs_SwitchTab	Switches to the next/previous tab.
SftTabs_TransparentControls	The dialogs used as pages of a tab control call SftTabs_TransparentControls to pass messages on to SftTabs/DLL so they can be processed.
SftTabs_UnregisterApp	Unregisters the application.
SftTabs_UnregisterDialog	Unregisters a dialog which has been previously registered using SftTabs_RegisterDialog or SftTabs_RegisterWindow.
SftTabs_UnregisterWindow	Unregisters a window which has been previously registered using SftTabs_RegisterDialog or SftTabs_RegisterWindow.