Show / Hide Table of Contents

Krypton Ribbon Merger

This module provides functionality for merging and unmerging Krypton Ribbon controls, enabling dynamic ribbon management in plugin architectures and modular applications.

Features

  • Ribbon Merging: Merge tabs, groups, and contexts from one ribbon into another
  • Ribbon Unmerging: Reverse merge operations to restore original ribbon state
  • UserControl Hosting: The KryptonRibbon can be hosted directly on UserControl instances (fully supported)
  • Extension Methods: Convenient extension methods for easy ribbon merging
  • Built-in Support: All functionality is built into the Krypton.Ribbon library

Documentation

For detailed developer documentation, see:

  • UserControl Hosting Guide - Complete guide to hosting KryptonRibbon on UserControls
  • Ribbon Merging Guide - Comprehensive guide to merging and unmerging ribbons
  • API Reference - Complete API documentation

Quick Start

UserControl Hosting

using Krypton.Ribbon;

public class PluginUserControl : UserControl
{
    private readonly KryptonRibbon ribbon;

    public PluginUserControl()
    {
        ribbon = new KryptonRibbon
        {
            Dock = DockStyle.Top,
            AutoSize = true,
            AutoSizeMode = AutoSizeMode.GrowAndShrink
        };
        
        // Configure ribbon tabs and groups...
        Controls.Add(ribbon);
    }

    public KryptonRibbon Ribbon => ribbon;
}

Ribbon Merging

using Krypton.Ribbon;

// Merge a plugin ribbon into the main ribbon
mainRibbon.Merge(pluginRibbon);

// Later, unmerge when plugin is unloaded
mainRibbon.Unmerge(pluginRibbon);

Examples

See the comprehensive demo in TestForm/RibbonMergerDemo.cs for a complete working example of both features.

Support

For issues, questions, or contributions, please visit the Krypton Suite GitHub repository.

Back to top Krypton Component Suite BSD 3-Clause License © Component Factory Pty Ltd, 2006 - 2016, All rights reserved. Modifications by Peter Wagner (aka PWagner1), Simon Coghlan (aka Smurf-IV), Giduac, Ahmed Abdelhameed, tobitege, KamaniAR, Lesandro Gotardo (aka lesandrog), Jorge A. Avilés (aka mcpbcs) et al. 2017 - 2025. All rights reserved. https://github.com/Krypton-Suite