CoreSuite.SplitButton 1.0.0

SplitButton

Button with a configurable drop-down area and ContextMenuStrip.

Overview

SplitButton extends NoFocusCueButton and provides button with a configurable drop-down area and ContextMenuStrip.

It is designed for .NET 8 Windows Forms applications and can be configured in code or through the Visual Studio designer where designer support applies.

Features

• Supports separate main-button and drop-down actions.
• Supports split and drop-down-only modes.
• Provides keyboard access and right-to-left layout.
• Allows the arrow, separator and drop-down area to be customized.
• Uses the standard Windows Forms event and component model.
• Includes English XML documentation for the public API.
• Requires no third-party packages.

Requirements

• Windows Forms
• .NET 8 for Windows (net8.0-windows)

Installation

Install the package from NuGet:

dotnet add package CoreSuite.SplitButton

Or use the Visual Studio NuGet Package Manager and search for:

CoreSuite.SplitButton

Namespace

Imports CoreSuite.Controls

Quick start

Imports CoreSuite.Controls

Dim Menu As New ContextMenuStrip()
Menu.Items.Add("Open")
Menu.Items.Add("Open read-only")

Dim OpenButton As New SplitButton With {
    .Text = "Open",
    .DropDownMenu = Menu,
    .Mode = SplitButtonMode.Split,
    .DropDownAreaWidth = 24
}
AddHandler OpenButton.DropDownOpening, Sub(Sender, E) E.Cancel = False

Designer usage

After installing or referencing the package, add SplitButton from the Toolbox or create it in code. Properties configured in the Windows Forms Designer are serialized into InitializeComponent and remain available at runtime.

API reference

SplitButton

Represents button with a configurable drop-down area and ContextMenuStrip.

Public Class SplitButton
    Inherits NoFocusCueButton

Main members

Behavior and validation

• Property changes take effect immediately unless a method explicitly starts or applies an operation.
• Callers should validate user input and referenced objects before performing application-specific work.
• Events use the standard Windows Forms event model and should be handled on the UI thread.

Standard functionality

Because SplitButton inherits from NoFocusCueButton, the standard public members of that base type remain available unless the control intentionally hides or overrides them.

Resource and lifetime considerations

• Dispose components, controls, images, fonts and menus created dynamically when your application owns them.
• Keep referenced controls alive for as long as a component is attached to them.
• File-based operations should receive valid, accessible paths.

Package information

License

This package is distributed under the MIT License defined by the CoreSuite repository.