mirror of
https://git.outfoxxed.me/quickshell/quickshell.git
synced 2025-11-04 19:04:56 +11:00
55 lines
2.5 KiB
QML
55 lines
2.5 KiB
QML
import QtQuick
|
|
|
|
///! Rectangle that handles sizes and positioning for a single visual child.
|
|
/// This component is useful for adding a border or background rectangle to
|
|
/// a child item. If you need to clip the child item to the rectangle's
|
|
/// border, see @@ClippingWrapperRectangle.
|
|
///
|
|
/// > [!NOTE] WrapperRectangle is a @@MarginWrapperManager based component.
|
|
/// > See its documentation for information on how margins and sizes are calculated.
|
|
///
|
|
/// > [!WARNING] You should not set @@Item.x, @@Item.y, @@Item.width,
|
|
/// > @@Item.height or @@Item.anchors on the child item, as they are used
|
|
/// > by WrapperItem to position it. Instead set @@Item.implicitWidth and
|
|
/// > @@Item.implicitHeight.
|
|
Rectangle {
|
|
id: root
|
|
|
|
/// If true (default), the rectangle's border width will be added
|
|
/// to @@extraMargin.
|
|
property bool contentInsideBorder: true
|
|
/// The default for @@topMargin, @@bottomMargin, @@leftMargin and @@rightMargin.
|
|
/// Defaults to 0.
|
|
property /*real*/alias margin: manager.margin
|
|
/// An extra margin applied in addition to @@topMargin, @@bottomMargin,
|
|
/// @@leftMargin, and @@rightMargin.
|
|
/// If @@contentInsideBorder is true, the rectangle's border width will be added
|
|
/// to this property. Defaults to 0.
|
|
property real extraMargin: 0
|
|
/// The requested top margin of the content item, not counting @@extraMargin.
|
|
///
|
|
/// Defaults to @@margin, and may be reset by assigning `undefined`.
|
|
property /*real*/alias topMargin: manager.topMargin
|
|
/// The requested bottom margin of the content item, not counting @@extraMargin.
|
|
///
|
|
/// Defaults to @@margin, and may be reset by assigning `undefined`.
|
|
property /*real*/alias bottomMargin: manager.bottomMargin
|
|
/// The requested left margin of the content item, not counting @@extraMargin.
|
|
///
|
|
/// Defaults to @@margin, and may be reset by assigning `undefined`.
|
|
property /*real*/alias leftMargin: manager.leftMargin
|
|
/// The requested right margin of the content item, not counting @@extraMargin.
|
|
///
|
|
/// Defaults to @@margin, and may be reset by assigning `undefined`.
|
|
property /*real*/alias rightMargin: manager.rightMargin
|
|
/// Determines if child item should be resized larger than its implicit size if
|
|
/// the parent is resized larger than its implicit size. Defaults to false.
|
|
property /*bool*/alias resizeChild: manager.resizeChild
|
|
/// See @@WrapperManager.child for details.
|
|
property alias child: manager.child
|
|
|
|
MarginWrapperManager {
|
|
id: manager
|
|
extraMargin: (root.contentInsideBorder ? root.border.width : 0) + root.extraMargin
|
|
}
|
|
}
|