BinaryPowerTabStrip

Creates an empty tab strip, 300 by 250 pixels, in the Visual Studio 2008 style with menu overflow.

The first page is selected when the strip first paints, unless one has been selected by then.

Gets the border style, which is always BorderStyle.None; the strip draws its own border (DrawBorderAroundTabStrip).

Gets the controls inside the strip, which are its pages. Use TabPages to add and remove tabs.

Gets or sets the colour the header fill ends at in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

A page's own BinaryPowerTabPage.CustomEndColor, when set, takes precedence for that page.

Gets or sets the colour the header fill starts from in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

The fill runs to CustomEndColor in the direction of TabPageHeaderDrawingGradientOrientation. A page's own BinaryPowerTabPage.CustomStartColor, when set, takes precedence for that page. The selected header uses the selection colours instead while UseTabCurrentSelectionIndicatorColor is on.

Gets or sets the colour of the bar that shows where a dragged header will land.

Gets or sets whether a one-pixel border is drawn round the whole strip.

The border is drawn in TabPageBorderColor.

Gets or sets whether neighbouring headers overlap, each slanting over the one before it, with the selected header on top.

Always on while TabRenderingStyle is RenderingStyle.TrapeziumTop; turning it off then has no effect.

Gets or sets the colour of the strip's drop shadow.

Gets or sets how far the strip's drop shadow reaches, which is also the width of the band it takes from the strip.

Gets or sets how dark the strip's drop shadow is at its strongest.

Gets or sets the space left before the first header of each row.

Gets or sets whether the header height is recalculated to fit the tallest caption or image whenever the strip's font or a page's image changes.

When on, a change to the strip's Control.Font, or to a page's BinaryPowerTabPage.Image or BinaryPowerTabPage.DisabledImage, sets TabPageHeaderHeight to the larger of the tallest image and the tallest caption (in the strip's font) plus a margin. Turning it on does not resize anything by itself. Either way the headers are never drawn shorter than their font and images need.

Gets or sets a layout option that the strip stores but does not act on.

Gets or sets whether users can drag a tab header to a new position.

A press becomes a drag once the held pointer moves past the system's drag distance. A bar marks where the header will land (ShowDragDropIndicator), and on release the page moves there in TabPages, raising TabPageSelectionChanged with TabPageChangeTriggerSource.Removed then TabPageChangeTriggerSource.Added. Turning this off cancels a drag in progress.

Gets or sets whether each tab header draws its own close button.

A button is drawn on a header whose page has both BinaryPowerTabPage.ShouldRenderCloseButton and BinaryPowerTabPage.IsHeaderEnabled on, and the header is widened by 20 logical pixels to make room (see ReserveCloseButtonSpaceOnAllTabPages). A click raises TabPageClosing; unless it is cancelled the page is removed and TabPageClosed is raised.

The buttons respond only while ShowCloseWindowButton is also on; with it off they are drawn but do nothing.

Gets or sets the colour of the thin outer line along the selected header's leading edge in the RenderingStyle.ExtendedWindowsXP style.

A two-pixel line in ExtendedWindowsXPRenderingSecondColor runs inside it. The colour is used from the next repaint.

Gets or sets the colour of the two-pixel inner line along the selected header's leading edge in the RenderingStyle.ExtendedWindowsXP style.

Gets or sets the space between two neighbouring headers, while TabPagesHaveGapBetweenThem is on.

Gets or sets the font of the header text, and gives it to every page.

Setting it replaces every page's BinaryPowerTabPage.HeaderTextFont, and a page added later is given it when it joins the strip; to give one tab its own font, set that page's font afterwards. The selected tab uses SelectedTabPageHeaderFont.

Gets or sets the extra width added to every header when the headers are auto-sized.

Used only while ShouldAutoSizeTabs is on; otherwise TabPageHeaderHorizontalPadding sets the room round each caption.

Gets or sets whether the strip's background, and its pages', is transparent.

Turning it on remembers Control.BackColor and sets it to Color.Transparent; turning it off restores it. The setting is passed to the pages the strip has at the time, not to pages added later.

Gets or sets whether the tooltip follows the pointer from header to header, rather than appearing only when the pointer rests.

When false, the tooltip appears when the pointer rests on the header it entered the strip over; moving onto another header hides it, and that header's tooltip appears only after the pointer has left the strip and come back.

When true, each movement over a header shows that header's tooltip at the pointer, and leaving the headers hides it.

Gets or sets a placement preference for new pages that the strip stores but does not use to place them.

AddTab() and AddTab() add the page as the last tab whichever the value. To add a page as the first tab, use AddTab().

Gets or sets whether the overflow glyph is drawn at OverflowMenuGlyphSize, or by your PowerTabStripElementsRenderer, rather than as the standard 16-pixel arrow.

While this is on, the strip-level close button (ShowCloseWindowButton) has no place; the close buttons on the headers are not affected.

Gets or sets the size of the overflow glyph's box while OverflowMenuGlyphDrawnInEnlargedMode is on.

Without a PowerTabStripElementsRenderer, each side must be from 16 to 32; a size outside that range is replaced by 16 by 16. With a renderer, any size is kept; the check is made when the size is set, so set the renderer first. Out of enlarged mode the glyph is always 16 by 16.

Gets or sets the font of the overflow menu's title.

Gets or sets the colour of the overflow menu's title.

Gets or sets the space round the overflow menu's title.

Gets or sets the title shown at the top of the overflow menu, while OverflowMenuShouldRenderTitleLabel is on.

Gets or sets whether the overflow menu starts with a title above the list of tabs.

The title is OverflowMenuLabelText, drawn in OverflowMenuLabelFont and OverflowMenuLabelForeColor.

tabs.OverflowMenuShouldRenderTitleLabel = true;
tabs.OverflowMenuLabelText = "Open documents";
tabs.OverflowMenuLabelFont = new Font("Segoe UI", 9f, FontStyle.Bold);
tabs.OverflowMenuLabelMargin = new Padding(4, 4, 4, 2);

Gets the tab headers drawn by the last paint, in the order they were drawn.

Gets or sets an object of your own that draws the overflow glyph, in place of the built-in drop-down arrow.

The renderer is called only while OverflowMenuGlyphDrawnInEnlargedMode is on. It draws into a box OverflowMenuGlyphSize in size at the right-hand end of the headers, and is told whether the pointer is over it (OverflowMenuGlyphVisualState). With a renderer set, OverflowMenuGlyphSize is not limited to 16 to 32 pixels – set the renderer first, then the size – so make TabPageHeaderHeight at least as tall as the glyph.

While a renderer is set, the strip-level close button (ShowCloseWindowButton) has no place.

public sealed class TabListGlyph : IPowerTabStripElementsRenderer
{
    public void RenderOverflowMenuGraphic(Graphics g, Rectangle bounds, OverflowMenuGlyphVisualState state)
    {
        Color back = state == OverflowMenuGlyphVisualState.Highlighted ? Color.FromArgb(204, 228, 247) : Color.Transparent;
        using (var fill = new SolidBrush(back))
        {
            g.FillRectangle(fill, bounds);
        }

        TextRenderer.DrawText(g, "All tabs", SystemFonts.MenuFont, bounds, SystemColors.ControlText,
                              TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter);
    }
}

tabs.OverflowMenuGlyphDrawnInEnlargedMode = true;
tabs.PowerTabStripElementsRenderer = new TabListGlyph();
tabs.OverflowMenuGlyphSize = new Size(72, 24);
tabs.TabPageHeaderHeight = 28;

Gets or sets whether changing a page's BinaryPowerTabPage.Text leaves the strip unpainted until this is turned off again.

Set it before renaming many tabs and clear it afterwards; clearing it repaints once. Only text changes are held back.

Gets or sets how a caption wider than TabPageHeaderWidth is shortened: in the middle, keeping its start and end, or at the end.

Either way the text is no wider than TabPageHeaderWidth; raise that to show long captions in full. The new value is used from the strip's next repaint.

Gets or sets whether room for a close button is added to every header, or only to the headers that draw one.

While EnableTabPageLevelCloseButtonRendering is on, 20 logical pixels are added to a header for its close button. A button is drawn only on a page whose BinaryPowerTabPage.ShouldRenderCloseButton and BinaryPowerTabPage.IsHeaderEnabled are on, so set this to false when some pages turn their button off and should not carry the empty room.

Auto-sized headers (ShouldAutoSizeTabs) stay uniform: they all get the room if any page draws a button.

Gets or sets whether the selected tab's header text is drawn in bold when SelectedTabPageHeaderFont is not set.

Set SelectedTabPageHeaderFont for any other look. Not shown in the designer's property grid.

Gets or sets the tab whose page is on show.

Setting it shows that page, hides the others and raises TabPageSelectionChanged. Setting null selects the first page instead, if it is BinaryPowerTabPage.Visible.

In OverflowMode.Menu mode, selecting a page whose header is not on show moves the page to the front of TabPages so its header comes into view – unless ShouldRespectTabPageSetupOrderUponSelectedPageChange is on.

Gets or sets the font of the selected tab's header text.

Left unset, the selected header uses the page's own BinaryPowerTabPage.HeaderTextFont, in bold while SelectedPageHeaderTextIsRenderedBold is on. Not used while TabPageHeaderTextFontOverridesControlDefault is on. The header height grows, if it must, to fit this font.

Gets or sets whether every header is given the same width – that of the widest.

When on, each header is as wide as the widest caption and image, plus HeaderTextCloseButtonExtraGap, the close button's room and 20 logical pixels. TabPageHeaderHorizontalPadding does not apply.

Gets or sets whether the strip casts a drop shadow along its bottom and right-hand edges.

A child control cannot paint outside itself, so the shadow is drawn in a band inside the strip's bounds, and the room for the headers and pages shrinks by DropShadowDepth on those two edges. The part of the band the shadow does not cover is filled with the colour of the nearest opaque container behind the strip.

Gets or sets whether each tab header casts a soft drop shadow down and to the right, the selected header's falling over its neighbours.

Each shadow follows its header's own outline. When the headers overlap (DrawTabPageOnTopOfEachOther, always the case with RenderingStyle.TrapeziumTop), only the selected header casts one.

Separate from ShouldDrawDropShadow, which shadows the whole strip; either, both or neither may be on.

tabs.ShouldDrawTabHeaderDropShadow = true;
tabs.TabHeaderDropShadowDepth = 4;
tabs.TabHeaderDropShadowOpacity = 60;

Gets or sets whether a header's text may run onto more than one line.

When on, line breaking is left to TabHeaderStringFormat, so a caption wider than TabPageHeaderWidth can wrap; make TabPageHeaderHeight tall enough to show the extra lines.

Gets or sets whether the strip writes a report of the headers on show to Trace when the pointer enters or leaves it.

Gets or sets whether each paint records the headers it drew in PagesCurrentlyDisplayedInActiveTabControlView.

Gets or sets whether selecting a tab whose header is out of view keeps the tabs in their order.

Applies in OverflowMode.Menu mode, when a page is chosen from the overflow menu or set as SelectedTabPage while its header is not on show.

• false – the page is moved to the front of TabPages, so its header becomes the first one shown.
• true – the order is kept, and the headers on show shift along so the selected one is the last in view.

Gets or sets whether the selected page is repainted at once whenever the form the strip is on is moved.

Gets or sets whether the selected page is repainted at once whenever the form the strip is on is resized.

The headers are laid out again after a resize either way; this also repaints the page's contents straight away, for pages whose controls draw themselves from the page's size.

Gets or sets whether the strip-level close button, at the right-hand end of the headers, closes the selected tab when clicked.

The button occupies a 16-logical-pixel square to the right of the overflow glyph, and has no place while OverflowMenuGlyphDrawnInEnlargedMode is on or a PowerTabStripElementsRenderer is set. It is drawn only in the designer; at run time a click on its place still closes the tab. The close buttons on the headers also respond only while this is on.

Gets or sets whether a header being dragged shows where it will land: a bar between two headers, with a caret at each end, in DragDropIndicatorColor.

The bar is shown only where a drop would move the page; outside the headers the pointer shows that a drop does nothing.

Gets or sets whether the overflow glyph – the drop-down that lists the tabs – is shown at the right-hand end of the headers.

Used in OverflowMode.Menu mode. With this off, headers that do not fit cannot be reached with the mouse.

Gets or sets whether a page's BinaryPowerTabPage.ToolTipText is shown when the pointer rests on its header.

Gets or sets the size of the strip, and lays the headers out again for the new size.

Gets or sets whether a header's close button sits near its top or its bottom edge when the tabs run along the bottom of the strip.

Applies only while TabPagesRenderingLocation is TabPagesRenderingLocation.Bottom, and not to RenderingStyle.TrapeziumTop headers.

Gets or sets the colour of the tab headers' drop shadows.

Gets or sets how far each tab header's drop shadow reaches.

Gets or sets how dark the tab headers' drop shadows are at their strongest.

Gets or sets the text layout used to measure and draw the header captions.

The strip adjusts the format's trimming and line-breaking flags as it lays out and paints (see RenderFullTextForTabPageHeader and ShouldDrawTabPageHeaderInMultiLines), and disposes the format it holds when it is disposed, so give it a format of its own rather than one shared with other code. The new format is used from the next repaint.

Gets or sets the colour of the headers' outline and of the border round the strip.

In the RenderingStyle.VisualStudio2008 style the strip sets this colour itself as it paints, unless ThemeBorderColorCanBeOverridden is on; turn that on to keep a colour of your own. The new colour is used from the next repaint.

Gets or sets the colour a header's close-button cross turns while the pointer is over it.

Gets or sets the outline of the box drawn behind the strip-level close button while the pointer is over it.

Gets or sets the fill of the box drawn behind the strip-level close button while the pointer is over it.

The close buttons on the headers do not draw this box.

Gets or sets the colour the selected header's fill ends at in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

Gets or sets the colour the selected header's fill starts from in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

The fill runs to TabPageCurrentSelectionIndicatorEndColor in the direction of TabPageHeaderDrawingGradientOrientation, while UseTabCurrentSelectionIndicatorColor is on.

Gets or sets the direction of the header fill's gradient in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

Gets or sets the colour of the header text.

A page's own BinaryPowerTabPage.TabPageHeaderForeColor, when set, takes precedence. The text of an unselected header whose page has BinaryPowerTabPage.IsHeaderEnabled off is drawn in SystemColors.GrayText.

Gets or sets the height of a row of tab headers.

The headers are never drawn shorter than their text needs – the selected tab's font height plus 11 logical pixels – nor than the tallest page image needs, so a larger font or image makes them taller without this value changing. A value larger than both is used as it is.

The page area starts below the headers (above them when TabPagesRenderingLocation is TabPagesRenderingLocation.Bottom), and in OverflowMode.MultiLine mode each row of headers takes this height. Unless TabPageHeaderHorizontalPadding is set, each header is also this much wider than its text.

// Taller headers for a touch-friendly screen.
tabs.TabPageHeaderHeight = 36;

Gets or sets the room added to each header's width on top of its text – the space that frames the caption.

Lower it to make every tab narrower without changing the font, so more headers fit before the overflow menu is needed.

Applies while ShouldAutoSizeTabs is off. Auto-sized tabs all take the width of the widest, and HeaderTextCloseButtonExtraGap sets their extra room instead.

// Compact tabs: 12 logical pixels round each caption instead of the header height.
tabs.TabPageHeaderHorizontalPadding = 12;

Gets or sets whether each header carries a coloured bar along its right-hand edge in the RenderingStyle.Custom style.

Drawn only in RenderingStyle.Custom with the tabs along the top, in the page's BinaryPowerTabPage.TabPageSideBarFillColor when set and otherwise the strip's TabPageSideBarFillColor. A value set while TabPagesRenderingLocation is TabPagesRenderingLocation.Bottom is ignored, so set the location first.

Gets or sets whether the selected tab's header text is drawn in its page's own BinaryPowerTabPage.HeaderTextFont, like the other headers, rather than in the selected-tab font.

With this on, SelectedTabPageHeaderFont and SelectedPageHeaderTextIsRenderedBold are not used. The new value is used from the strip's next repaint.

Gets or sets the widest a header's text may be; longer captions are shortened with an ellipsis.

A header is as wide as its text up to this width, plus its padding, image and close button. How a longer caption is shortened depends on RenderFullTextForTabPageHeader.

Changing it lays the headers out again at once.

Gets or sets the colour of the side bar on each header, when TabPageHeaderShowsSideBar is on.

A page's own BinaryPowerTabPage.TabPageSideBarFillColor, when set, takes precedence for that page.

Gets the strip's pages, in tab order.

Gets or sets the colour of the cross on the close buttons.

Gets or sets whether the headers are spaced apart by GapBetweenTabPages rather than drawn edge to edge.

Gets or sets the background of the overflow menu, including its image margin.

// A dark overflow menu to match a dark window.
tabs.TabPagesOverFlowMenuBackColor = Color.FromArgb(37, 37, 38);
tabs.TabPagesOverFlowMenuForeColor = Color.Gainsboro;
tabs.TabPagesOverFlowMenuBorderColor = Color.FromArgb(63, 63, 70);
tabs.TabPagesOverFlowMenuHighlightColor = Color.FromArgb(62, 62, 64);
tabs.TabPagesOverFlowMenuShowImageMargin = false;

Gets or sets the colour of the overflow menu's border and separators.

Gets or sets the colour of the overflow glyph – the bar and arrow the menu drops from – rather than of the menu itself.

The menu's own colours are TabPagesOverFlowMenuBackColor and the properties beside it.

Gets or sets the font of the overflow menu.

Gets or sets the colour of the overflow menu's text.

Gets or sets the outline of the box drawn behind the overflow glyph while the pointer is over it.

Gets or sets the fill of the box drawn behind the overflow glyph while the pointer is over it.

Gets or sets the colour drawn behind, and round, the item the pointer is over in the overflow menu.

Gets or sets a text colour for the overflow menu's highlighted item, which the menu does not use.

The highlighted item's text is drawn in the same colour as the others (TabPagesOverFlowMenuForeColor); choose a TabPagesOverFlowMenuHighlightColor that it reads well against.

Gets or sets whether the overflow menu keeps the strip down its left-hand side where item images go.

Turning it off gives a flatter, themed look; do so only if the pages carry no images (BinaryPowerTabPage.Image, BinaryPowerTabPage.OverflowMenuImage).

Gets or sets how many auto-sized tabs the strip assumes fit on a row when it fills rows by counting tabs rather than measuring them.

Matters only while ShouldAutoSizeTabs is on and the rows are counted by tab width rather than measured – that is, with UseLegacyMultiLineRowPacking on. TabPagesOverflowCalculationStrategy.Pessimistic allows one tab fewer per row than would fit; TabPagesOverflowCalculationStrategy.Optimistic allows as many as fit. Setting it lays the strip out again.

Gets or sets whether the tab headers run along the top or the bottom of the strip.

The page area moves to the other side of the headers. With the headers at the bottom, TabBottomOrientationCloseButtonPosition places the close buttons, and the side bar (TabPageHeaderShowsSideBar) is not drawn.

Gets or sets the shape and colouring of the tab headers.

The Visual Studio and Windows XP styles have fixed colours. RenderingStyle.Custom and RenderingStyle.TrapeziumTop fill the headers from CustomStartColor to CustomEndColor (or a page's own BinaryPowerTabPage.CustomStartColor and BinaryPowerTabPage.CustomEndColor), and the selected header from the selection colours (UseTabCurrentSelectionIndicatorColor).

Choosing RenderingStyle.TrapeziumTop also turns on DrawTabPageOnTopOfEachOther, which stays on if another style is chosen later. Setting this property does not raise TabStyleRenderingStyleChanged.

tabs.TabRenderingStyle = RenderingStyle.Custom;
tabs.CustomStartColor = Color.FromArgb(225, 236, 248);
tabs.CustomEndColor = Color.White;
tabs.TabPageCurrentSelectionIndicatorStartColor = Color.FromArgb(0, 120, 215);
tabs.TabPageCurrentSelectionIndicatorEndColor = Color.FromArgb(153, 201, 239);

Gets or sets what the strip does when the headers are wider than it is: keep one row and list the tabs in a drop-down menu, or wrap them onto extra rows.

In OverflowMode.Menu mode as many headers are shown as fit, always including the selected one, and a glyph at the right-hand end (ShowOverflowMenuGlyph) lists every visible tab whose header is enabled. In OverflowMode.MultiLine mode every header is shown, the page area shrinks by one TabPageHeaderHeight per extra row, and there is no glyph.

Gets or sets whether border colours you set are kept in the styles that otherwise set their own.

While this is off, the RenderingStyle.VisualStudio2008, RenderingStyle.WindowsXP and RenderingStyle.ExtendedWindowsXP styles set each page's BinaryExtendedPanel.BorderColor as they paint, and the Visual Studio 2008 style also sets TabPageBorderColor.

Gets or sets how the tab headers' tooltips look and behave: their delays, colours, icon, title and style.

The settings are applied each time a tooltip is shown, so changing a property of the current object takes effect at the next tooltip. The text of each tooltip is the page's BinaryPowerTabPage.ToolTipText.

tabs.ToolTipConfiguration.IsBalloon = true;
tabs.ToolTipConfiguration.ToolTipIcon = ToolTipIcon.Info;
tabs.ToolTipConfiguration.ToolTipTitle = "Document";
tabs.ToolTipConfiguration.InitialDelay = 300;

Gets or sets whether the rows of headers in OverflowMode.MultiLine mode are filled by counting tabs rather than by measuring them.

With false, each row takes as many headers as genuinely fit, measured at the width each is painted at.

With true, every header is assumed to be TabPageHeaderWidth wide, so rows usually hold fewer tabs than would fit and wrap earlier. Use it only to keep a layout that depends on that rule.

Gets or sets whether the selected header is filled with the selection colours in the RenderingStyle.Custom and RenderingStyle.TrapeziumTop styles.

Adds a page as the last tab, without selecting it.

The page is docked to fill the page area and TabPageSelectionChanged is raised with TabPageChangeTriggerSource.Added. The first page added to an empty strip is selected when the strip next paints.

Adds a page as the last tab, and selects it if asked to.

Raises TabPageSelectionChanged with TabPageChangeTriggerSource.Added, and again with TabPageChangeTriggerSource.SelectionChanged when the page is selected.

Adds a page as the first or the last tab, and selects it if asked to.

// A new search result opens as the first tab, and is shown straight away.
var results = new BinaryPowerTabPage { Text = "Results: \"overdue invoices\"" };
results.Controls.Add(resultsGrid);
tabs.AddTab(results, true, true);

Releases the strip's resources, disposing every page it holds, the overflow menu and the tooltip.

Makes a grey copy of an image, as a disabled header draws its page's image when it has no BinaryPowerTabPage.DisabledImage.

A new bitmap, in shades of grey, with the colour of its top-left pixel made transparent. The caller disposes it.

Gets the tab whose header is at a point.

The page whose header contains the point, or null if there is none. Only headers on show count.

Tells which part of the strip is at a point: a header, a header's close button, the overflow glyph, the strip-level close button, or none of them.

The part at the point. A point on a header whose page has BinaryPowerTabPage.IsHeaderEnabled off, or on a button that is switched off, gives HitTestArea.None. Never throws.

Headers are tested where they were last painted, so a header that is not on show is never hit.

tabs.MouseUp += (sender, e) =>
{
    // A right-click on a header offers that tab's own menu.
    if (e.Button == MouseButtons.Right && tabs.HitTest(e.Location) == HitTestArea.TabPage)
    {
        tabContextMenu.Tag = tabs.GetTabPageByPoint(e.Location);
        tabContextMenu.Show(tabs, e.Location);
    }
};

Starts watching the form and containers around the strip, for a strip added to a form that already exists, then carries on as the base class does.

Raises TabPageDoubleClicked for a double-click on a header, and the Control.DoubleClick event for a double-click anywhere else.

A double-click on a header, a close button or the overflow glyph does not raise Control.DoubleClick.

Raises the Control.FontChanged event, and recalculates the header height when EnableAutomaticUpdateOfTabPagesHeaderSize is on.

Raises the Control.HandleCreated event, and starts watching the form and containers around the strip so the headers are laid out again when they resize.

Stops watching the form and containers around the strip, then raises the Control.HandleDestroyed event.

Selects the next tab when Ctrl+Tab reaches the strip, then raises the Control.KeyDown event.

The next tab is the next page in TabPages; on the last page, Ctrl+Tab does nothing.

Raises the Control.Layout event, and at run time works out again how many headers fit.

Raises the Control.MouseCaptureChanged event, and abandons a header drag whose capture was taken away while the button is still down – by a window activated from the keyboard, or a dialog - so nothing is dropped later and no bar is left behind.

Raises the Control.MouseDown event, then acts on a left-button press: selects the tab under the pointer, opens the overflow menu, or closes a tab whose close button was pressed.

Raises the Control.MouseEnter event, and notes the header the pointer entered over, for its tooltip.

Raises the Control.MouseHover event, and shows the tooltip of the header under the pointer.

Raises the Control.MouseLeave event, hides any tooltip and clears the highlights on the buttons.

Raises the Control.MouseMove event, then carries a header drag along, or updates the tooltips and the highlights on the close buttons and the overflow glyph.

Raises the Control.MouseUp event, and drops a header being dragged at the place the drop bar shows.

Paints the headers, the overflow glyph and any drop bar; the Control.Paint event is not raised.

Raises the Control.ParentBackColorChanged event, and repaints the drop-shadow band, which shows the colour behind the strip.

Raises the Control.ParentChanged event, and starts watching the strip's new form and containers when it is moved to another parent at run time.

Raises the Control.Resize event, and resizes the page area to the room the headers leave.

Raises the Control.SizeChanged event, then works out again how many headers fit and lays them out for the new size.

Raises the Control.SystemColorsChanged event and repaints the strip, whose default colours come from the system palette.

Raises the TabStyleRenderingStyleChanged event.

Moves a page to a new position among the tabs.

Does nothing on a strip with no pages. The page is taken out and put back, so TabPageSelectionChanged is raised twice: TabPageChangeTriggerSource.Removed, then TabPageChangeTriggerSource.Added.

Lays the headers and the page area out again from scratch.

Call it after a change the strip does not watch – for example a page's BinaryPowerTabPage.HeaderTextFont, which does not lay the headers out again by itself.

Removes a page from the strip and selects a neighbouring tab.

The page is removed from TabPages (raising TabPageSelectionChanged with TabPageChangeTriggerSource.Removed) but is not disposed. Then, while pages remain, the page that was just before it is selected – the first visible page if it was the first – whether or not the removed page was the selected one. With Control.RightToLeft on, the page after it is selected instead.

Neither TabPageClosing nor TabPageClosed is raised.

Does nothing. Calling it has no effect on the strip.

Works out again how many headers fit, lays the strip out and repaints it.

Use it after a change that affects how many headers fit in OverflowMode.Menu mode, such as new captions on several pages.

Sets the strip's bounds with layout suspended on the strip and every control inside it, so the pages are laid out once for the new size.

Tells the designer whether to write Control.Font into the designer file: only when it differs from the system's default font.

Part of the designer's serialisation support; not for use from application code. Returns true when the strip has pages.

Part of the designer's serialisation support; not for use from application code. Always returns true.

Processes the strip's window messages, reserving and painting the drop-shadow band when ShouldDrawDropShadow is on.

The band is part of the window's non-client area, along the right and bottom edges, so the headers, the border and the pages all cast the shadow.

Occurs just before the strip lays its headers out again.

The event data is the name of the member whose change set off the layout – for example "TabPageHeaderHeight", "Size" or "OnSizeChanged" – so a handler can react to some causes and not others.

Do not set the member named in the event data from the handler: that starts another layout, and raises the event again.

tabs.TabElementsLayoutChanging += (sender, changedMember) =>
{
    if (changedMember == nameof(BinaryPowerTabStrip.TabPageHeaderHeight))
    {
        statusLabel.Text = "Header height changed";
    }
};

Occurs after the user has closed a tab with a close button and its page has been removed.

The event data does not say which page; note it in TabPageClosing if needed.

Occurs when the user clicks a close button, before the page is removed; a handler can cancel.

TabPageClosingEventArgs.TabPage is the page about to close. Set Cancel to keep it; otherwise it is removed with RemoveTab and TabPageClosed follows. Removing a page from code does not raise this event.

Occurs when the user double-clicks a tab header.

Not raised for a header whose page has BinaryPowerTabPage.IsHeaderEnabled off, nor for the close buttons or the overflow glyph.

// Double-clicking a tab opens its document in a window of its own.
tabs.TabPageDoubleClicked += (sender, e) => OpenInNewWindow(e.TabPage);

Occurs when the selected tab changes, and also when a page is added, removed or changed.

TabPageChangedEventArgs.TabPageChangeType tells the cases apart:

• TabPageChangeTriggerSource.SelectionChanged – another tab was selected, by the user or through SelectedTabPage; the page is null if none could be.
• TabPageChangeTriggerSource.Added, TabPageChangeTriggerSource.Removed – a page joined or left TabPages; moving a page raises both.
• TabPageChangeTriggerSource.Changed – a page's BinaryPowerTabPage.Visible changed, or pages were added with BinaryPowerTabPageCollection.AddRange (page null).

Occurs when OnTabStyleRenderingStyleChanged is called.

The strip does not call it itself – setting TabRenderingStyle does not raise this event - so it is raised only by a derived class.