Revit二次开发 - 族库最近使用菜单

RibbonGallery

---

当时在“构件坞”中看到这种样式的ribbon菜单，觉得挺有意思的，于是找它的实现方案：

1、首先用Adwindows找到“构件坞”的Tab；

2、再找到“最近使用”的Panel，看看它里面的控件是啥对象；

3、这样就找到了RibbonGallery，发现它在我们常使用的“RevitAPIUI.dll”中是没有封装，那么就只有Adwindows了；

4、最后搜索找资料，几乎没有... ...这只能结合调试时对象的属性，测试如何使用，挺麻烦的。（当然可以反编译构件坞，虽然加密了，但也能看个大概.. - -#）

Adwindows对菜单的操作是非常灵活的，A平台Ribbon菜单应该都是它做的，它的实现与平台环境是无关的，之所以按钮能相应Revit命令是因为后台绑定的Command，所有找到绑定的数据可以随意操作菜单，包括在指定位置插入新菜单，调整菜单位置等等，美中不足的是没有官方文档，只是靠自己摸索。

其实Revit给我们封装的菜单绝大部分情况是够用了，就插件而言，花里胡哨的菜单应该挺少的吧。

---

好了，看看具体实现吧：

1、首先在你菜单的位置创建“最近使用”的Panel，根据上诉第2点的方法，可以看到要创建什么对象加入该Panel。

            const string recentPanelName = "最近使用";
            var adTab = Autodesk.Windows.ComponentManager.Ribbon.Tabs.First(o => o.Title == addin.HDTabs.First().Name);
            _recentPanel = new Autodesk.Windows.RibbonPanel() { };
            _recentPanel.Source = new Autodesk.Windows.RibbonPanelSource();
            _recentPanel.Source.Title = recentPanelName;
            adTab.Panels.Insert(1, _recentPanel);

            _recentPanel.Source.Items.Add(new Autodesk.Windows.RibbonGallery() { Name = "_ribbonGallery_recent" });
            _recentPanel.IsVisible = false;

2、初始化RibbonGallery，给它的 ItemsBinding 和 ItemTemplate 属性准备数据，其实你可以把RibbonGallery当成WPF中的ItemsControl控件，ItemsBinding是绑定数据源，ItemTemplate就是数据模板。

            var adTab = ComponentManager.Ribbon.Tabs.First(o => o.Title == _addinApp.HDTabs.First().Name);
            _adPanel = adTab.Panels.First(o => o.Source.Title == "最近使用");
            _gallery = _adPanel.Source.Items.First() as RibbonGallery;
            //绑定数据
            var binding = new System.Windows.Data.Binding
            {
                Source = this,
                Path = new PropertyPath("Items", new object[0]),
                Mode = System.Windows.Data.BindingMode.OneWay
            };
            _gallery.ItemWidth = ImageWidth;
            _gallery.ItemHeight = ImageHeight;
            _gallery.ResizeStyle = RibbonItemResizeStyles.ChangeSize;
            _gallery.DisplayMode = GalleryDisplayMode.Window;
            _gallery.ResizableBoxWidth = 0.0;
            _gallery.IsVirtualizing = true;
            _gallery.RowsInWindowMode = 1;
            _gallery.ShowImage = true;
            _gallery.ItemsBinding = binding;
            //绑定样式
            var resourceLocator = new Uri("WXVisual.FamilyLibrary.Revit;component/Resource/RecentElmType.xaml", UriKind.Relative);
            var dictionary = (ResourceDictionary)System.Windows.Application.LoadComponent(resourceLocator);

            var dataTemplate = dictionary["family"] as DataTemplate;
            _gallery.ItemTemplate = dataTemplate;

如果你问ItemWidth、ItemHeight、ResizeStyle、DisplayMode等等这些属性的值从哪来时，我会告诉你是在调试“构件坞”的Ribbon菜单的对象中找的。。。

3、最后，创建我们的Item模板样式。

 <DataTemplate x:Key="family">
        <Border BorderThickness="1" CornerRadius="2" BorderBrush="Gray" ToolTip="{Binding ToolTip}">
            <Image Source="{Binding LargeImage}" Width="55" Height="55">
                <Image.Style>
                    <Style TargetType="Image">
                        <Setter Property="LayoutTransform">
                            <Setter.Value>
                                <ScaleTransform></ScaleTransform>
                            </Setter.Value>
                        </Setter>
                        <Style.Triggers>
                            <EventTrigger RoutedEvent="Image.MouseEnter">
                                <EventTrigger.Actions>
                                    <BeginStoryboard>
                                        <Storyboard>
                                            <DoubleAnimation Storyboard.TargetProperty="LayoutTransform.ScaleX" To="1.1" Duration="0:0:0.25"></DoubleAnimation>
                                            <DoubleAnimation Storyboard.TargetProperty="LayoutTransform.ScaleY" To="1.1" Duration="0:0:0.25"></DoubleAnimation>
                                        </Storyboard>
                                    </BeginStoryboard>
                                </EventTrigger.Actions>
                            </EventTrigger>
                            <EventTrigger RoutedEvent="Image.MouseLeave">
                                <EventTrigger.Actions>
                                    <BeginStoryboard>
                                        <Storyboard>
                                            <DoubleAnimation Storyboard.TargetProperty="LayoutTransform.ScaleX" To="1" Duration="0:0:0.25"></DoubleAnimation>
                                            <DoubleAnimation Storyboard.TargetProperty="LayoutTransform.ScaleY" To="1" Duration="0:0:0.25"></DoubleAnimation>
                                        </Storyboard>
                                    </BeginStoryboard>
                                </EventTrigger.Actions>
                            </EventTrigger>
                        </Style.Triggers>
                    </Style>
                </Image.Style>
            </Image>
        </Border>
    </DataTemplate>

---

上面就是现实“最近使用”菜单的主要逻辑，理解理解应该能应用到项目中，有啥问题，可以联系我。