navigate Logo

Getting Started

  • Computer Considerations
  • Computer Power Configuration
  • Software Installation
  • Launching Navigate
  • Configuring Navigate
  • Acquiring Data
  • Smart Acquisition Routines

User Guide

  • Supported Hardware
  • Supported File Formats
  • User Interface Walkthrough
  • Setting Up a Microscope
  • Acquiring Data
  • Case Studies

Development

  • Contributing Guidelines
  • Developer Install
  • Software Architecture
  • Developer Architecture Concepts
  • Feature Container
  • REST API
  • Plugin Architecture
  • Adding New Hardware

Troubleshooting & Known Issues

  • Troubleshooting
  • Known Issues

Plugins

  • navigate Plugin Template
  • navigate Confocal Projection
  • navigate at Scale
  • navigate Constant Velocity Acquisition
  • navigate MMCore
  • navigate ilastik Server
  • navigate Photoactivation

Reference

  • Implemented Microscopes
  • Software API
    • navigate.config
    • navigate.controller
    • navigate.controller.configurator
    • navigate.log_files
    • navigate.model
    • navigate.tools
    • navigate.view
      • navigate.view.configurator_application_window
      • navigate.view.custom_widgets
        • navigate.view.custom_widgets.ArrowLabel
        • navigate.view.custom_widgets.CollapsibleFrame
        • navigate.view.custom_widgets.DockableNotebook
        • navigate.view.custom_widgets.LabelInputWidgetFactory
        • navigate.view.custom_widgets.common
        • navigate.view.custom_widgets.hover
        • navigate.view.custom_widgets.popup
        • navigate.view.custom_widgets.scrollbars
        • navigate.view.custom_widgets.validation
      • navigate.view.main_application_window
      • navigate.view.main_window_content
      • navigate.view.popups
      • navigate.view.splash_screen
      • navigate.view.theme
navigate
  • Software API
  • navigate.view
  • navigate.view.custom_widgets
  • navigate.view.custom_widgets.DockableNotebook
  • navigate.view.custom_widgets.DockableNotebook.DockableNotebook
  • View page source

navigate.view.custom_widgets.DockableNotebook.DockableNotebook

class navigate.view.custom_widgets.DockableNotebook.DockableNotebook(parent, root, *args, **kwargs)

Bases: Notebook

Dockable Notebook that allows for tabs to be popped out into a separate windows by right-clicking on the tab. The tab must be selected before right-clicking.

__init__(parent, root, *args, **kwargs)

Initialize Dockable Notebook

Parameters:
  • parent (Tk parent widget.) – The parent widget being passed down for hierarchy and organization. Typically, a ttk.Frame or tk.Frame.

  • root (Tk top-level widget.) – Tk.tk GUI instance.

  • *args – Options for the ttk.Notebook class

  • **kwargs – Keyword options for the ttk.Notebook class

Methods

__init__(parent, root, *args, **kwargs)

Initialize Dockable Notebook

dismiss(tab_widget)

Dismiss the popout window.

find(event)

Find the widget that was clicked on.

get_absolute_position()

Get absolute position of mouse.

popout()

Popout the currently selected tab.

set_tablist(tab_list)

Setter for tab list

Attributes

  • root

  • selected_tab_id

  • tab_list

  • menu

dismiss(tab_widget)

Dismiss the popout window.

This is called when the popout window is closed. It destroys the popout window and re‐inserts the tab into the notebook.

Parameters:

tab_widget (ttk.Frame) – The tab widget to be dismissed.

find(event: Event) → None

Find the widget that was clicked on.

Will check if the proper widget element in the event is what we expect.

In this case its checking that the label in the tab has been selected. It then gets the proper position and calls the popup.

Parameters:

event (tk.Event) – Tkinter event object

get_absolute_position() → tuple

Get absolute position of mouse.

This helps the popup menu appear where the mouse is right-clicked.

Returns:

x, y – Coordinates to be used (x, y)

Return type:

integers

popout() → None

Popout the currently selected tab.

Gets the currently selected tab, the tabs name and checks if the tab name is in the tab list. If the tab is in the list, it’s removed from the list, hidden, and then passed to a new Top Level window.

set_tablist(tab_list: list) → None

Setter for tab list

Parameters:

tab_list (list) – The list of tab variables

menu

Tkinter menu

Type:

tk.Menu

root

Tkinter root

Type:

tk.Tk

selected_tab_id

Selected tab id where user right-clicked.

Type:

int

tab_list

List of tab variables

Type:

list

Previous Next

© Copyright 2026, Dean Lab, UT Southwestern Medical Center.