How to add new button in Organize panel using C#?

The WPF PDF Viewer default organize panel has three button items - the Rotation button and the Delete button. To add a new button to the organization panel, the PDF viewer allows us to do so during the Window_Loaded event. This can be achieved at the sample level by adding the new button to the toolbar of the organize panel.

We have accessed the stack panel within the thumbnail panel and added a NEW button to its children. This panel is used in both the thumbnail panel and the organize panel. To hide the button’s visibility when the thumbnail pane is opened, we have set it to be hidden when the thumbnail is checked, and unchecked the visibility when it is closed.

Steps to add new button in organize panel using C#

The below steps illustrate how to add a new button to the organize panel in the WPF PDF Viewer.

Step 1: Trigger the AddButton() method from the Window_Loaded event.

• Wire the AddButton method in the Window_Loaded event.

C#

private void Window_Loaded(object sender, RoutedEventArgs e)
{
  AddButton();
}

Step 2: Add new button in organize panel.

• Initialization of UI Elements: The AddButton() method initializes various UI elements required for displaying PDF thumbnails and outlines. It retrieves references to these elements from the PDF viewer’s template using the FindName() method.
• Event Handling: Within AddButton(), event handlers ThumbnailButton_Checked and ThumbnailButton_Unchecked are attached to the Checked and Unchecked events of a ToggleButton named thumbnailButton. These event handlers control the visibility of a Button.
• Button Creation and Configuration: Inside AddButton(), a new Button named button is created and configured. It’s given specific dimensions, margin, and content (“New”).

C#

private void AddButton()
{
   OutlinePane outlinePane = pdfViewer.Template.FindName("PART_OutlinePane", pdfViewer) as OutlinePane;
   ToggleButton thumbnailButton = (ToggleButton)outlinePane.Template.FindName("PART_ThumbnailButton", outlinePane);
   thumbnailButton.Checked += ThumbnailButton_Checked;
   thumbnailButton.Unchecked += ThumbnailButton_Unchecked;
   ThumbnailPane thumbnailPane = pdfViewer.Template.FindName("PART_ThumbnailPanel", pdfViewer) as ThumbnailPane;
   StackPanel stack = (StackPanel)thumbnailPane.Template.FindName("Thumb_StackPanel", thumbnailPane);
   button = new Button();
   button.Margin = new Thickness(10, 0, 0, 0);
   button.Width = 35;
   button.Height = 24;
   button.Content = "New";
   stack.Children.Add(button);
}
       

Step3: Checked and unchecked the button’s visibility on thumbnail panel.

• The visibility of the button is toggled based on the Checked and Unchecked states of thumbnailButton. When thumbnailButton is checked, indicating the thumbnail view is active, button is hidden (Visibility.Collapsed). When thumbnailButton is unchecked, indicating the thumbnail view is not active, button is made visible (Visibility.Visible).

C#

private void ThumbnailButton_Unchecked(object sender, RoutedEventArgs e)
{
 button.Visibility = Visibility.Visible;
}
private void ThumbnailButton_Checked(object sender, RoutedEventArgs e)
{
 button.Visibility = Visibility.Collapsed;
}

A complete working sample to add new button in Organize panel using C# can be downloaded from GitHub.

The execution of the above code results in the addition of a new button to the Organize panel, appearing as follows.

See Also:

• Organize pages in WPF Pdf Viewer
• How to add a custom tool to the standard toolbar of WPF PDF Viewer?