Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-71951

add QML API for window mask

XMLWordPrintable

    • Icon: Suggestion Suggestion
    • Resolution: Unresolved
    • Icon: P4: Low P4: Low
    • None
    • None
    • Quick: Core Declarative QML
    • None

      The mask could perhaps be an image (where alpha < threshold makes that part of the window transparent) or a Shape or some sort of rendered layer or maybe just any part of the window that is transparent.

      Since most window systems do compositing, it's already been possible to have visually transparent windows since Qt 5.0. And since 5.11, a MouseArea or a Pointer Handler can avoid handling events outside a masked shape (using Item.containmentMask). But setting the window mask would allow the mouse and touch events to fall through; and it would also provide visual masking on non-compositing window managers.

      This isn't very urgent since it's easy enough to do in C++ already. But we have a number of open bugs about window masking not working correctly on various platforms and in various situations. Making the mask available in QML would exacerbate those.

        For Gerrit Dashboard: QTBUG-71951
        # Subject Branch Project Status CR V
        198347,3 WIP: Add Window.mask to set QWindow::setMask() from QML dev qt/qtdeclarative Status: NEW -2 0

            qt.team.quick.subscriptions Qt Quick and Widgets Team
            srutledg Shawn Rutledge
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:

                There is 1 open Gerrit change