ActivationInitialActionDelay Property

The number of milliseconds after the first GalleryItem is activated before the ItemActivated event is fired.

Syntax

Visual Basic

'Declaration
 
Public Property ActivationInitialActionDelay As Integer

C#

public int ActivationInitialActionDelay {get; set;}

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	If the property is set to a value that is less than zero.

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 use the ActivationInitialActionDelay property to specify the number of milliseconds after the first GalleryItem is activated before the ItemActivated event is fired.

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()
           galleryTool.ActivationActionDelay = 200
           galleryTool.ActivationInitialActionDelay = 1000
        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.ActivationActionDelay = 200;
            galleryTool.ActivationInitialActionDelay = 1000;
        }
    }
}

XAML

<igRibbon:XamRibbonWindow x:Class="MyWindow"
    xmlns:igRibbon="http://infragistics.com/Ribbon">

    ....

    <igRibbon:RibbonGroup Id="groupId" Caption="GroupName">
            <igRibbon:MenuTool ShouldDisplayGalleryPreview="True" Caption="GalleryToolMenu">
                    <igRibbon:GalleryTool Name="galleryTool" ActivationInitialActionDelay="1000"
                                                      ActivationActionDelay="200"/>
                 </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