TabView_t::Draw (Windows Embedded CE 6.0)

1/6/2010

This method draws the tab controls for a property sheet.

Syntax

static void Draw(
  HWND hwnd,
  HWND hwndParent,
  HDC hdc,
  RECT* prcClient,
  DWORD style,
  DWORD dwStyleEx,
  UINT flags,
  int tmHeight,
  int cItems,
  HIMAGELIST himl,
  HDPA hdpa,
  int cbExtra,
  int iSel,
  int iNewSel,
  int cxTabs,
  int iFirstVisible,
  int iLastVisible,
  int iLastTopRow
);

Parameters

• hwnd
  [in] Handle to a window.

• hwndParent
  [in] Handle to the parent window.

• hdc
  [in] Handle to the device context.

• prcClient
  [out] Pointer to a RECT structure that receives the coordinates of the rectangle in which you want to draw.

• style
  [in] DWORD that specifies the style of the tab control. The following table shows the possible values.

  Tab control styles	Description
  TCS_BOTTOM	Displays the tabs at the bottom of the control. If the TCS_VERTICAL style is also specified, this style is interpreted as TCS_RIGHT.
  TCS_BUTTONS	Displays all tabs as buttons with no border drawn around the display area.
  TCS_FIXEDWIDTH	Specifies that all tabs are the same width. You cannot combine this style with the TCS_RIGHTJUSTIFY style.
  TCS_FLATBUTTONS	Changes the appearance of a selected tab to indented while other tabs appear to be on the same plane as the background. This style only applies to tab controls that have the TCS_BUTTONS style.
  TCS_FLIP	Flips all tabs from top to bottom or left to right.
  TCS_FOCUSNEVER	Creates a tab control that never receives the input focus.
  TCS_FOCUSONBUTTONDOWN	Specifies that a given tab, when selected, receives the input focus.
  TCS_FORCEICONLEFT	Aligns an icon with the left edge of a fixed-width tab. This style can only be used with the TCS_FIXEDWIDTH style.
  TCS_FORCELABELLEFT	Aligns a label with the left edge of a fixed-width tab; that is, it displays the label immediately to the right of the icon instead of centering it. This style can only be used with the TCS_FIXEDWIDTH style, and it implies the TCS_FORCEICONLEFT style.
  TCS_MULTILINE	Displays multiple rows of tabs, if necessary, so that all tabs are visible at once.
  TCS_MULTISELECT	Specifies that multiple tabs can be selected by holding down CTRL when selecting a tab. This style only applies to tabs that have the TCS_BUTTONS style.
  TCS_OWNERDRAWFIXED	Specifies that the parent window is responsible for drawing tabs.
  TCS_RAGGEDRIGHT	Leaves a ragged right edge by not stretching a row of tabs to fill the entire width of the control. This style is the default.
  TCS_RIGHT	Displays multiple tabs vertically on the right side of controls that use the TCS_VERTICAL style. If the TCS_VERTICAL style is not specified, this style is interpreted as TCS_BOTTOM.
  TCS_RIGHTJUSTIFY	Increases the width of each tab, if necessary, so that each row of tabs fills the entire width of the tab control. This style is valid only when it is used with the TCS_MULTILINE style.
  TCS_SCROLLOPPOSITE	Specifies that unused tabs move to the opposite side of the control when a new tab is selected.
  TCS_SINGLELINE	Displays only one row of tabs. The user can scroll to see more tabs, if necessary. This style is the default.
  TCS_VERTICAL	Displays multiple tabs vertically on the left side of the control. This style is valid only when it is used with the TCS_MULTILINE style. To make tabs appear on the right side of the control, combine this style with the TCS_RIGHT style.

• dwStyleEx
  [in] DWORD that specifies the extended style of the tab control. The following table shows the possible value.

  Value	Description
  TCS_EX_FLATSEPARATORS	Draws a separator between tab items in tab controls that have the TCS_BUTTONS or TCS_FLATBUTTONS style.

• flags
  [in] Unsigned integer that specifies how to draw the tabs. The following table shows the possible values.

  Value	Description
  TCF_BUTTONS	Uses buttons instead of tabs when drawing the property sheet.
  TCF_DRAWSUNKEN	Draws the button so that the button appears pressed.
  TCF_FONTCREATED	Indicates that the font set the font for the tab.
  TCF_FONTSET	Allows you to set the font for the tab.
  TCF_REDRAW	Uses the state of the redraw flag from the WM_SETREDRAW message.

• tmHeight
  [in] Integer that specifies the height of characters for the tab control.

• cItems
  [in] Integer that specifies the number of tabs.

• himl
  [in] Handle to an image list.

• hdpa
  [in] Handle to a DPA structure.

• cbExtra
  [in] Integer that specifies the number of extra bytes in the TCM_SETITEMEXTRA message.

• iSel
  [in] Integer that specifies the index of the tab that you want to be selected.

• iNewSel
  [in] Integer that specifies the index of the button that has the focus.

• cxTabs
  [in] Integer that specifies the x-coordinate of the right edge of the region where the tab can be painted.

• iFirstVisible
  [in] Integer that specifies the index of the first visible tab.

• iLastVisible
  [in] Integer that specifies the index of the last visible tab.

• iLastTopRow
  [in] Integer that specifies the index of the last tab in the top row of tabs.

Return Value

None.

Requirements

See Also

Reference

TabView_t
TCM_SETITEMEXTRA
WM_SETREDRAW
DPA
RECT