PdfPopupMenuShowingEventArgs.ItemLinks Property

Gets the collection of popup menu links displayed when the menu is being invoked.

Namespace: DevExpress.XtraPdfViewer

Assembly: DevExpress.XtraPdfViewer.v23.2.dll

NuGet Package: DevExpress.Win.PdfViewer

Declaration

C#

public BarItemLinkCollection ItemLinks { get; }

VB.NET

Public ReadOnly Property ItemLinks As BarItemLinkCollection

Property Value

Type	Description
BarItemLinkCollection	A BarItemLinkCollection object that contains links to a popup menu.

Example

This example demonstrates how to add a custom item to the popup menu.

Form1.cs

using DevExpress.XtraBars;
using DevExpress.XtraBars.Ribbon;
using DevExpress.XtraPdfViewer;
using System.Windows.Forms;
//...

void pdfViewer1_PopupMenuShowing(object sender, PdfPopupMenuShowingEventArgs e) {

    // Create a bar button item.
    BarButtonItem browseBarButton = new BarButtonItem();
    browseBarButton.Caption = "Custom Item";

    // Insert the bar button item 
    // and start a new group.
    e.ItemLinks.Add(browseBarButton, true);

    // Handle the bar button click event.
    browseBarButton.ItemClick += browseBarButton_ItemClick;
}

void browseBarButton_ItemClick(object sender, ItemClickEventArgs e) {
    MessageBox.Show("ItemClick event fires");
}

Form1.vb

Imports System.Windows.Forms
Imports DevExpress.XtraPdfViewer
Imports DevExpress.XtraBars

'...
Private Sub pdfViewer1_PopupMenuShowing(ByVal sender As Object, ByVal e As PdfPopupMenuShowingEventArgs) Handles pdfViewer1.PopupMenuShowing
    ' Create a bar button item.
    Dim browseBarButton As New BarButtonItem()
    browseBarButton.Caption = "Custom Item"

    ' Insert the bar button item into the PDF Viewer popup menu and start a new group.
    e.ItemLinks.Add(browseBarButton, True)

    ' Handle the bar button click event.
    AddHandler browseBarButton.ItemClick, AddressOf browseBarButton_ItemClick
End Sub

Private Sub browseBarButton_ItemClick(ByVal sender As Object, ByVal e As ItemClickEventArgs)
    MessageBox.Show("ItemClick event fires")
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ItemLinks property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-pdf-viewer-manage-popup-menu-items/CS/RemoveItemsFromPopupMenu/Form1.cs#L21

for (int i = e.ItemLinks.Count - 1; i >= 0; i--) {
    BarItemLink link = e.ItemLinks[i];
    if (link.Caption.Contains("Rotate"))

VB.NET

winforms-pdf-viewer-manage-popup-menu-items/VB/RemoveItemsFromPopupMenu/Form1.vb#L24

For i As Integer = e.ItemLinks.Count - 1 To 0 Step -1
    Dim link As BarItemLink = e.ItemLinks(i)
    If link.Caption.Contains("Rotate") Then e.ItemLinks.Remove(link)