ShowPreviewInRibbon Property

Gets or sets the value indicating whether the gallery preview should be displayed if this tool is on the ribbon.

Syntax

Visual Basic

'Declaration
 
Public Property ShowPreviewInRibbon As Boolean

C#

public bool ShowPreviewInRibbon {get; set;}

Remarks

Note: The preview will not be displayed if any of the following is true:

• ShowInPreview is set to false
• The tool's InstanceProps.ButtonGroup property has been set.
• The tool's InstanceProps.PreferredSizeOnRibbon property has been set to Normal or ImageOnly.
• The RibbonGroup.PreferredToolSize of the ToolBase.OwningRibbonGroup property has been set to Normal or ImageOnly.

Example

This sample demonstrates how to customize the behavior of a popup gallery.

Visual Basic

Imports Infragistics.Win.UltraWinToolbars

Private Sub button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button9.Click
	' Get the gallery from the toolbars manager which will be customized
	Dim gallery As PopupGalleryTool = Me.UltraToolbarsManager1.Tools("PopupGalleryTool1")

	' Prevent the user from resizing the gallery drop down by hiding the grab handle
	gallery.AllowResizeDropDown = False

	' Hide the filter bar in the gallery drop down.  If this is set to false, the selected filter 
	' can only be programmatically changed by setting SelectedGroupFilter or SelectedGroupFilterKey.
	gallery.ShowFilterBar = False

	' Prevent the gallery preview from showing in the ribbon
	gallery.ShowPreviewInRibbon = False

	' Use images from the UltraToolbarsManager.ImageListSmall in the gallery item
	gallery.UseLargeImagesInItems = False
End Sub

C#

using System.Windows.Forms;
using Infragistics.Win.UltraWinToolbars;

private void button1_Click( object sender, EventArgs e )
{
	// Get the gallery from the toolbars manager which will be customized
	PopupGalleryTool gallery = (PopupGalleryTool)this.ultraToolbarsManager1.Tools[ "PopupGalleryTool1" ];

	// Prevent the user from resizing the gallery drop down by hiding the grab handle
	gallery.AllowResizeDropDown = false;

	// Hide the filter bar in the gallery drop down.  If this is set to false, the selected filter 
	// can only be programmatically changed by setting SelectedGroupFilter or SelectedGroupFilterKey.
	gallery.ShowFilterBar = false;

	// Prevent the gallery preview from showing in the ribbon
	gallery.ShowPreviewInRibbon = false;

	// Use images from the UltraToolbarsManager.ImageListSmall in the gallery item
	gallery.UseLargeImagesInItems = false;
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, 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