EasyRibbon - Framework Tạo Revit Ribbon UI Đơn Giản Với C# Attributes

// Traditional way - verbose and hard to maintain
public Result OnStartup(UIControlledApplication application)
{
    // Create Ribbon Tab
    string tabName = "My Tools";
    application.CreateRibbonTab(tabName);
    
    // Create Ribbon Panel
    RibbonPanel panel = application.CreateRibbonPanel(tabName, "Design Tools");
    
    // Create Push Button
    PushButtonData buttonData = new PushButtonData(
        "ColumnRebar",
        "Column Rebar",
        Assembly.GetExecutingAssembly().Location,
        "MyAddin.Commands.ColumnRebarCommand"
    );
    
    // Set button image
    buttonData.Image = new BitmapImage(new Uri("pack://application:,,,/MyAddin;component/Resources/Icons/icon16.png"));
    buttonData.LargeImage = new BitmapImage(new Uri("pack://application:,,,/MyAddin;component/Resources/Icons/icon32.png"));
    
    // Set tooltip
    buttonData.ToolTip = "Generate column reinforcement";
    
    // Add button to panel
    PushButton button = panel.AddItem(buttonData) as PushButton;
    
    // And this is just for ONE button...
    return Result.Succeeded;
}

using EasyRibbon.UIAttributeBase;

[Tab("My Tools")]
public class MyToolsTab
{
    [Panel("Design Tools")]
    public class DesignPanel
    {
        [Button("Column Rebar",
            typeof(ColumnRebarCommand),
            Image = "/MyAddin;component/Resources/Icons/icon16.png",
            LargeImage = "/MyAddin;component/Resources/Icons/icon32.png",
            ToolTip = "Generate column reinforcement")]
        public class ColumnRebarButton;
    }
}

# Clone repository
git clone https://github.com/PhanCongVuDuc/EasyRibbon.git

# Build solution trong Visual Studio
# Reference EasyRibbon.dll vào project Revit Add-in của bạn

[Tab("My Tools")]
public class MyToolsTab
{
    [Panel("Design Tools")]
    public class DesignPanel
    {
        [Button("Column Rebar",
            typeof(ColumnRebarCommand),
            Image = "/MyAddin;component/Resources/Icons/icon16.png",
            LargeImage = "/MyAddin;component/Resources/Icons/icon32.png",
            ToolTip = "Generate column reinforcement",
            LongDescription = "Automatically generate reinforcement for concrete columns",
            ToolTipImage = "path/to/tooltip.png",
            ContextualHelp = "https://help-url.com")]
        public class ColumnRebarButton;
    }
}

[Button("Button Text",
    typeof(CommandClass),
    Image = "path/to/16x16.png",
    LargeImage = "path/to/32x32.png",
    ToolTip = "Tooltip text",
    LongDescription = "Detailed description",
    ToolTipImage = "path/to/tooltip.png",
    ContextualHelp = "https://help-url.com")]
public class MyButton;

// Stacked Buttons (3 buttons xếp chồng)
[StackedButton]
public class StructuralTools
{
    [Button("Beam Design", typeof(BeamCommand), ...)]
    public class BeamButton;
    
    [Button("Column Design", typeof(ColumnCommand), ...)]
    public class ColumnButton;
}

// Pulldown Button (Menu dropdown)
[PulldownButtonData("Rebar Tools", Image = "path/to/16x16.png")]
public class RebarToolsPulldown
{
    [Button("Beam Rebar", typeof(BeamRebarCommand), ...)]
    public class BeamRebar;
    
    [Button("Column Rebar", typeof(ColumnRebarCommand), ...)]
    public class ColumnRebar;
}

using EasyRibbon.Modules;
using Autodesk.Revit.UI;

public class MyModule : IApplicationModule
{
    public string ModuleName => "My Custom Module";
    
    public void OnStartup(UIControlledApplication application)
    {
        // Create UI from attribute-defined classes
        CreateUIApp.CreateUI<MyToolsTab>(application);
    }
    
    public void OnShutdown(UIControlledApplication application)
    {
        // Cleanup if needed
    }
}

using Nice3point.Revit.Toolkit.External;

public class Application : ExternalApplication
{
    private readonly MyModule _module = new MyModule();
    
    public override void OnStartup()
    {
        _module.OnStartup(Application);
    }
    
    public override void OnShutdown()
    {
        _module.OnShutdown(Application);
    }
}

using Nice3point.Revit.Toolkit.External;
using EasyRibbon.Modules;

public class MasterApplication : ExternalApplication
{
    private readonly ModuleRegistry _moduleRegistry = new ModuleRegistry();
    
    public override void OnStartup()
    {
        // Register all modules
        _moduleRegistry.RegisterModule<StructuralModule>();
        _moduleRegistry.RegisterModule<MEPModule>();
        _moduleRegistry.RegisterModule<ArchitectureModule>();
        
        // Initialize all modules at once
        _moduleRegistry.InitializeAll(Application);
    }
    
    public override void OnShutdown()
    {
        // Shutdown all modules
        _moduleRegistry.ShutdownAll(Application);
    }
}

EasyRibbon/
├── EasyRibbon/                     # Core library
│   ├── UIAttributeBase/            # Attribute definitions
│   ├── Extensions/                 # Helper extensions
│   ├── Modules/                    # Module system
│   └── CreateUIApp.cs              # Main UI builder
├── EasyRibbonExample/              # Single module example
│   ├── Application.cs              # Standalone entry point
│   ├── ExampleModule.cs            # Module implementation
│   └── SonnyTab1.cs                # UI definition
└── EasyRibbonMasterExample/        # Multi-module example
    └── Application.cs              # Master application