Skip to main content

PyQt custom titlebar window (resizable, movable, minimize/maximize/close, etc.)

Project description

pyqt-custom-titlebar-window

PyQt custom titlebar window(resizable, movable, minimize/maximize/close).

User can set modernized and customized frame surrounding the widget you made.

You can set the title bar separately or set the menu bar as title bar.

Basic buttons like min/max/close are automatically set by user's OS.

You can set your customized buttons(e.g. min/max/close).

You can drag title bar or menu bar on widget to move the window, double-click it to show maximize/normal.

This also makes the application's font look better by setting the font family to 'Arial'(which looks modern and commonly used), antialiasing.

The range of font size is set to 9~12 which is not too big, not too small.

If you want to set custom titlebar easily than use pyqt-custom-titlebar-setter.

If you want to use this in various ways than use this directly. see the example below.

Table of Contents

Requirements

PyQt5 >= 5.15 - This package is using startSystemMove, startSystemResize which were both introduced in Qt 5.15.

Setup

python -m pip install pyqt-custom-titlebar-window

Included Packages

Feature

  • If you drag the frame, window will be resized.

  • If you drag the title bar(menu bar if there is no title bar) of inner widget, window will be moved.

  • If you double-click the menu bar, window will be maximized/normalized.

  • Set the window title by itself if you set your inner widget's title with setWindowTitle. It also catches the windowTitleChanged signal of your inner widget.

  • Support full screen feature. When full screen feature turns on, top title bar will disappear. Reappear when it turns off.

  • CustomTitlebarWindow(CustomizedWidgetByUser()) - Constructor.

  • setTopTitleBar(self, title: str = '', icon_filename: str = '', font: QFont = QFont('Arial', 14), align=Qt.AlignCenter, bottom_separator=False) to set title bar on the top of the window. font size should be at least 14.

  • setButtons(btnWidget=None, align=Qt.AlignRight) to add buttons(e.g. min/max/close) on the top right/left corner of title/menu bar. If btnWidget is set to None, buttons' style are automatically set to your platform/OS friendly style. Basically you can give btnWidget to your customized buttons(pyqt-titlebar-buttons-widget). I will explain it better. Sorry for weak explanation.

  • setButtonHint(hint) to set hints of buttons. There are three options available(close, min/close, min/max/close). Default value is min/max/close.

  • setMenuTitle(title: str, icon_filename: str, font=QFont('Arial', 14)) to set the icon and title not only on the left side of menu bar, but also set it as window icon and title. font size should be at least 14.

  • Frame's color synchronizes with the QMenuBar's background color or inner QWidget's color if inner widget is not QMainWindow.

  • getCornerWidget() to get corner widget of QMenuBar easily

  • getInnerWidget() to get inner widget easily

Example

Code Sample (Menu bar only)

from PyQt5.QtWidgets import QApplication

from pyqt_custom_titlebar_window import CustomTitlebarWindow

from pyqt_dark_calculator import Calculator



if __name__ == "__main__":

  import sys



  app = QApplication(sys.argv)

  customTitlebarWindow = CustomTitlebarWindow(Calculator())

  customTitlebarWindow.setMenuTitle(icon_filename='calculator.svg')

  # customTitlebarWindow.setButtonHint(hint=['close'])

  customTitlebarWindow.setButtons()

  customTitlebarWindow.show()

  app.exec_()

In the code sample, pyqt-dark-calculator is being used as inner widget.

Result

image

Here's another example with pyqt-dark-notepad.

image

As you see, existing corner widget doesn't matter.

Code Sample (Including title bar)

from PyQt5.QtWidgets import QApplication

from pyqt_custom_titlebar_window import CustomTitlebarWindow

from pyqt_dark_notepad import DarkNotepad



if __name__ == "__main__":

  import sys



  app = QApplication(sys.argv)

  window = DarkNotepad()

  customTitlebarWindow = CustomTitlebarWindow(window)

  customTitlebarWindow.setTopTitleBar(icon_filename='dark-notepad.svg')

  # customTitlebarWindow.setButtonHint(['close'])

  customTitlebarWindow.setButtons()

  customTitlebarWindow.show()

  app.exec_()

Result

image

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyqt-custom-titlebar-window-0.0.27.tar.gz (7.0 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file pyqt-custom-titlebar-window-0.0.27.tar.gz.

File metadata

File hashes

Hashes for pyqt-custom-titlebar-window-0.0.27.tar.gz
Algorithm Hash digest
SHA256 9ff09681c8005af8f6bbb5daddd8e768adef881e3cb0ce5870ea922b678a2c47
MD5 17014c284240c2ea138fcfec40029d03
BLAKE2b-256 cccf7f4abd997aad752de7ac5e95bddb4241b45f97d04b248e5ef1ccdbad872e

See more details on using hashes here.

File details

Details for the file pyqt_custom_titlebar_window-0.0.27-py3-none-any.whl.

File metadata

File hashes

Hashes for pyqt_custom_titlebar_window-0.0.27-py3-none-any.whl
Algorithm Hash digest
SHA256 ed3d8219223e06d65154c261e8081cc6f3abb6ce80050fc00f224674eb6c1cb4
MD5 747fdfbc7235e98ed2a271db1ecca117
BLAKE2b-256 4cdb70cc6f87f991501df09e55769c09dd3d6a2e5678a38c4f43c195d4298bbf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page