SFTTABS_GRAPH Structure
Describes a tab's picture component and its location.
typedef struct tagSftTabsGraph {
WORD location;
WORD type;
union tagSftTabsItem {
HICON hIcon;
HBITMAP hBitmap;
struct tagSftTabsImage {
short iImage;
short iImageDisabled;
} Image;
} item;
} SFTTABS_GRAPH, * LPSFTTABS_GRAPH;Members
location
Describes the location of the bitmap, relative to the tab text. The following values can be used:
| SFTTABS_GRAPH_NONE | No bitmap or icon, text is centered horizontally and vertically. |
| SFTTABS_LEFTVALIGN | No bitmap or icon, text is left aligned. Use this option for tab controls with a vertical orientation to line up the tab text on the left side. The text is centered vertically. |
| SFTTABS_RIGHTVALIGN | No bitmap or icon, text is right aligned. Use this option for tab controls with a vertical orientation to line up the tab text on the right side. The text is centered vertically. |
| SFTTABS_GRAPH_LEFTVALIGN | Bitmap or icon, tab picture is left aligned, followed by the tab text. Use this option for tab controls with a vertical orientation to line up the tab picture on the left side. The text and picture are centered vertically. |
| SFTTABS_GRAPH_RIGHTVALIGN | Bitmap or icon, tab picture is right aligned. The tab text is located to the left of the tab picture. Use this option for tab controls with a vertical orientation to line up the tab picture on the right side. The text and picture are centered vertically. |
| SFTTABS_GRAPH_TOP | Bitmap or icon, tab picture is above the tab text. The text and picture are centered horizontally. |
| SFTTABS_GRAPH_BOTTOM | Bitmap or icon, tab picture is below the tab text. The text and picture are centered horizontally. |
| SFTTABS_GRAPH_LEFT | Bitmap or icon, tab picture is on the left of the tab text. The text and picture are centered horizontally and vertically. |
| SFTTABS_GRAPH_RIGHT | Bitmap or icon, tab picture is on the right of the tab text. The text and picture are centered horizontally and vertically. |
If a rotated font is used, the orientation of the font's base line is used to determine the actual location of the bitmap or icon.
type
This member is provided for compatibility with versions prior to SftTabs/DLL 6.5. Instead, the SFTTABS_TAB, TabPicture member should be used to define the tab picture. If the TabPicture member defines a picture, the type member is ignored.
Describes the type of tab picture. The following values can be used:
| 0 | No tab picture. |
| SFTTABS_GRAPH_ICON | Tab picture is an icon. The hIcon field of the item union contains a valid icon handle. |
| SFTTABS_GRAPH_BITMAP | Tab picture is a bitmap. The hBitmap field of the item union contains a valid bitmap handle. |
| SFTTABS_GRAPH_IMAGELIST | Tab picture is defined using an ImageList control. The iImage and iImageDisabled fields of the Image union contain the index of the image to be used. |
hIcon
This member is provided for compatibility with versions prior to SftTabs/DLL 6.5. Instead, the SFTTABS_TAB, TabPicture member should be used to define the tab picture. If the TabPicture member defines a picture, the type member is ignored.
An icon handle, used as tab picture if type is defined as SFTTABS_GRAPH_ICON.
hBitmap
This member is provided for compatibility with versions prior to SftTabs/DLL 6.5. Instead, the SFTTABS_TAB, TabPicture member should be used to define the tab picture. If the TabPicture member defines a picture, the type member is ignored.
A bitmap handle, used as tab picture if type is defined as SFTTABS_GRAPH_BITMAP. The top, left pixel of the bitmap must contain the image's background color. This color will be replaced by the actual window background color when the bitmap is displayed.
iImage
This member is provided for compatibility with versions prior to SftTabs/DLL 6.5. Instead, the SFTTABS_TAB, TabPicture member should be used to define the tab picture. If the TabPicture member defines a picture, the type member is ignored.
The picture index used as tab picture if type is defined as SFTTABS_GRAPH_IMAGELIST. The picture is drawn transparently, based on the definition of the picture in the ImageList control. This iImage index is used only if the tab is enabled. If the tab is disabled, iImageDisabled is used instead. The picture index refers to the ImageList control defined using the SFTTABS_TAB structure. If hImageList in the SFTTABS_TAB structure is NULL, the default ImageList defined using the SFTTABS_CONTROL structure is used instead.
iImageDisabled
This member is provided for compatibility with versions prior to SftTabs/DLL 6.5. Instead, the SFTTABS_TAB, TabPicture member should be used to define the tab picture. If the TabPicture member defines a picture, the type member is ignored.
The picture index used as tab picture if type is defined as SFTTABS_GRAPH_IMAGELIST. The picture is drawn transparently, based on the definition of the picture in the ImageList control. This iImageDisabled index is used only if the tab is disabled. If the tab is enabled, iImage is used instead. The picture index refers to the ImageList control defined using the SFTTABS_TAB structure. If hImageList in the SFTTABS_TAB structure is NULL, the default ImageList defined using the SFTTABS_CONTROL structure is used instead.
Comments
The SFTTABS_GRAPH structure describes a tab's picture component and its location.
Applications developed using SftTabs/DLL 6.5 (or newer) should use the SFTTABS_TAB, TabPicture member to define the tab picture. Only the location member of this structure is used to define the location of the tab picture.
There are no default tab bitmaps or icons. Bitmap and icon handles are owned by the application. The handles have to remain valid until they are no longer used by the tab control, usually until the tab control is destroyed. The application is responsible for deleting the handles when they are no longer used.
See Also C/C++ API | C++ Classes | Notifications
On
Off