Ribbon Creator – 8: Stacked Group and PushButton - RevitNetAddinWizard & NavisworksNetAddinWizard

Let’s see how to create a stacked group which holds some PushButton items using RevitAddinWizard.

After the Ribbon Creator tool of the Revit Addin Coder is clicked, the Ribbon Creator window will appear. Then we can indicate a Stacked group is going to be created in a ribbon panel of interest through specifying Begin as the start of the group, End as the last, and some PushButton in between.

As all PushButton members will only use the Image property to display small icons, please pick up some 16x16 pixel bitmaps for these buttons. Though bigger size images can be chosen and fed to the Image property of the stacked PushButton, its look is bad. Such a case has been demonstrated in the third PushButton of the stacked group. Each stacked PushButton can still trigger a command for sure.

After the OK button is pressed, the following code will be created:

        public void AddRibbonItemsToRibbonPanel(RibbonPanel panel)
        {
            string assemFullName = Assembly.GetExecutingAssembly().Location;
            string assemPath = Path.GetDirectoryName(assemFullName);

            PushButtonData cnt1Stacked_grp0_item1Data = new PushButtonData("cnt1Stacked_grp0_item1", @"PushButton 1", assemFullName, "RevitAddinCSProject.ExtCmd1");
            PushButtonData cnt1Stacked_grp0_item2Data = new PushButtonData("cnt1Stacked_grp0_item2", @"PushButton 1", assemFullName, "RevitAddinCSProject.ExtCmd2");
            PushButtonData cnt1Stacked_grp0_item3Data = new PushButtonData("cnt1Stacked_grp0_item3", @"PushButton 1", assemFullName, "RevitAddinCSProject.ExtCmd3");
            IList<RibbonItem> cnt1Stacked = panel.AddStackedItems(cnt1Stacked_grp0_item1Data, cnt1Stacked_grp0_item2Data, cnt1Stacked_grp0_item3Data);

            PushButton cnt1Stacked_grp0_item1 = cnt1Stacked[0] as PushButton;
            cnt1Stacked_grp0_item1.ToolTip = @"PushButton 1 in a Stacked Group";
            cnt1Stacked_grp0_item1.Image = BmpImageSource(@"RevitAddinCSProject.Resources.smalla.bmp");

            PushButton cnt1Stacked_grp0_item2 = cnt1Stacked[1] as PushButton;
            cnt1Stacked_grp0_item2.ToolTip = @"PushButton 2 in a Stacked Group";
            cnt1Stacked_grp0_item2.Image = BmpImageSource(@"RevitAddinCSProject.Resources.smallb.bmp");

            PushButton cnt1Stacked_grp0_item3 = cnt1Stacked[2] as PushButton;
            cnt1Stacked_grp0_item3.ToolTip = @"PushButton 3 in a Stacked Group With a Big Image";
            cnt1Stacked_grp0_item3.Image = BmpImageSource(@"RevitAddinCSProject.Resources.BigC.bmp");

        }

        public static System.Windows.Media.ImageSource BmpImageSource(string embeddedPath)
        {
            Stream stream = Assembly.GetExecutingAssembly().GetManifestResourceStream(embeddedPath);
            var decoder = new System.Windows.Media.Imaging.BmpBitmapDecoder(stream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
            return decoder.Frames[0];
        }

So to repeat, there is no need to specify a big image for the LargeImage property of the stacked PushButton or its data class PushButtonData.

If some extra code is added to the same External Application:

                RibbonPanel panel = _cachedUiCtrApp.CreateRibbonPanel(Guid.NewGuid().ToString());
                AddRibbonItemsToRibbonPanel(panel);
                panel.Name = "ABC_APP3_PNL2";
                panel.Title = "Buttons created by the RevitAddinWizard";

something like the following will be added to the Revit Ribbon (depending on what the specified images really look like):

All the above is supported by RevitAddinWizard.