バージョン

ItemActivated イベント

GalleryItem が起動された後に発生します。ActivationActionDelay および ActivationInitialActionDelay プロパティで指定された値を超える時間、マウスが項目上に止まると GalleryItem が起動されます。
シンタックス
'宣言
 
Public Event ItemActivated As EventHandler(Of GalleryItemEventArgs)
public event EventHandler<GalleryItemEventArgs> ItemActivated
イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、GalleryItemEventArgs 型の引数を受け取りました。次の GalleryItemEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ解説
GalleryTool Infragistics.Windows.Ribbon.GalleryItem に関連付けられた GalleryTool インスタンスを返します (読み取り専用)。
Group Infragistics.Windows.Ribbon.GalleryItem に関連付けられた Infragistics.Windows.Ribbon.GalleryItemGroup インスタンスを返します (読み取り専用)。
Handled System.Windows.RoutedEventArgsから継承されます。Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Item Infragistics.Windows.Ribbon.GalleryItem を返します(読み取り専用)。
OriginalSource System.Windows.RoutedEventArgsから継承されます。Gets the original reporting source as determined by pure hit testing, before any possible System.Windows.RoutedEventArgs.Source adjustment by a parent class.
RoutedEvent System.Windows.RoutedEventArgsから継承されます。Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source System.Windows.RoutedEventArgsから継承されます。Gets or sets a reference to the object that raised the event.
解説

ActivationActionDelay および ActivationInitialActionDelay プロパティそして ItemActivated イベントは、Office 2007 アプリケーション (たとえば、Word) にあるライブ プレビュー機能をシミュレートするために使用できます。ユーザーが行っているプレビューに適切な遅延を指定し(たとえば、より頻繁なプレビューに対して長い時間遅延を指定して、GalleryItem がマウスオーバーされるたびにアプリケーションはプレビューしない)、プレビューを表示するために ItemActivated イベントを処理します。

使用例
Imports System
Imports System.Windows
Imports Infragistics.Windows.Ribbon


Namespace MyNamespace
    Public Partial Class MyWindow
        Inherits XamRibbonWindow
        Public Sub New()
            InitializeComponent()
        End Sub
       
        Private Sub SetupGalleryTool()
            AddHandler galleryTool.ItemActivated, AddressOf OnItemActivated
        End Sub
       
        Private Sub OnItemActivated(ByVal sender As Object, ByVal e As Infragistics.Windows.Ribbon.Events.GalleryItemEventArgs)
            Console.WriteLine("Activated item text is: {0}", e.Item.Text)
        End Sub
    End Class
End Namespace
using System;
using System.Windows;
using Infragistics.Windows.Ribbon;


namespace MyNamespace
{
    public partial class MyWindow : XamRibbonWindow
    {
        public MyWindow()
        {
            InitializeComponent();
        }

        private void SetupGalleryTool()
        {
            galleryTool.ItemActivated += new EventHandler<Infragistics.Windows.Ribbon.Events.GalleryItemEventArgs>(OnItemActivated);
        }

        private void OnItemActivated(object sender, Infragistics.Windows.Ribbon.Events.GalleryItemEventArgs e)
        {
            Console.WriteLine("Activated item text is: {0}", e.Item.Text);
        }
    }
}
<igRibbon:XamRibbonWindow x:Class="SnippetApp.Window1"
    
xmlns:igRibbon="http://infragistics.com/Ribbon">
    
    ....
    
<igRibbon:RibbonGroup Id="groupId" Caption="Group">
          
<igRibbon:MenuTool ShouldDisplayGalleryPreview="True" Caption="GalleryToolMenu">
               
<igRibbon:GalleryTool Name="galleryTool" ItemBehavior="StateButton" ItemActivated="galleryTool_ItemActivated" >
            ...
            
</igRibbon:GalleryTool>
        
</igRibbon:MenuTool>
    
</igRibbon:RibbonGroup>
    ....

</igRibbon:XamRibbonWindow>
参照