ItemActivated Event

Occurs after a GalleryItem has been activated. A GalleryItem is activated after the mouse pauses over the item for an amount of time that exceeds the values specified in ActivationActionDelay and ActivationInitialActionDelay properties.

Syntax

Visual Basic

'Declaration
 
Public Event ItemActivated As EventHandler(Of GalleryItemEventArgs)

C#

public event EventHandler<GalleryItemEventArgs> ItemActivated

Event Data

The event handler receives an argument of type GalleryItemEventArgs containing data related to this event. The following GalleryItemEventArgs properties provide information specific to this event.

Property	Description
GalleryTool	Returns the GalleryTool instance associated with the Infragistics.Windows.Ribbon.GalleryItem (read-only).
Group	Returns the Infragistics.Windows.Ribbon.GalleryItemGroup instance associated with the Infragistics.Windows.Ribbon.GalleryItem (read-only).
Handled (Inherited from 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	Returns the Infragistics.Windows.Ribbon.GalleryItem (read-only).
OriginalSource (Inherited from 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 (Inherited from System.Windows.RoutedEventArgs)	Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source (Inherited from System.Windows.RoutedEventArgs)	Gets or sets a reference to the object that raised the event.

Remarks

The ActivationActionDelay and ActivationInitialActionDelay properties and ItemActivated event can be used to simulate the Live Preview functionality found in Office 2007 applications (e.g., Word). Specify a delay that makes sense for the preview you are doing (e.g., longer delay for more expensive previews so that your application is not constructing previews everytime a GalleryItem is moused over), and handle the ItemActivated event to display the preview.

Example

The following example shows how to assign event handlers and how to handle the ItemActivated event.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Visual Basic

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

C#

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);
        }
    }
}

XAML

<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>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2