Pages
API Documentation
On this page

WindowThumbnail QML Type

Renders a thumbnail for the window specified by the winId property. More...

  • Import Statement: import org.kde.plasma.core
  • Inherits: Item

Detailed Description

This declarative item is able to render a live updating thumbnail for the window specified by the given winId property. If it is not possible to get the thumbnail, the window's icon is rendered instead or in case that the window Id is invalid a generic fallback icon is used.

The thumbnail does not necessarily fill out the complete geometry as the thumbnail gets scaled keeping the aspect ratio. This means the thumbnail gets rendered into the center of the item's geometry.

Note: live updating thumbnails are only implemented on the X11 platform. On X11 a running compositor is not required as this item takes care of redirecting the window. For technical reasons the window's frame is not included on X11.

If the window closes, the thumbnail does not get destroyed, which allows to have a window close animation.

Example usage:

WindowThumbnail {
    winId: 102760466
}

Property Documentation

paintedHeight : real

paintedWidth : real

thumbnailAvailable : bool

winId : int

We use cookies to personalize content and to analyze our traffic. Please decide if you are willing to accept cookies from our website.