QtShellChrome QML Type

Proporciona la funcionalidad de gestor de ventanas por defecto para su uso con la extensión qt-shell. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• bottomLeftResizeHandle : Item
• bottomResizeHandle : Item
• bottomRightResizeHandle : Item
• frameMarginBottom : int
• frameMarginLeft : int
• frameMarginRight : int
• frameMarginTop : int
• hasDecorations : bool
• leftResizeHandle : Item
• maximizedRect : rect
• rightResizeHandle : Item
• shellSurfaceItem : ShellSurfaceItem
• titleBar : Item
• topLeftResizeHandle : Item
• topResizeHandle : Item
• topRightResizeHandle : Item
• windowFlags : int
• windowState : int

Métodos

• void activate()
• void deactivate()
• void lower()
• void raise()
• void toggleFullScreen()
• void toggleMaximized()
• void toggleMinimized()

Descripción detallada

QtShellChrome es un tipo de conveniencia que se puede utilizar para proporcionar funcionalidad de gestor de ventanas a la interacción con los clientes a través del protocolo de extensión de shell qt-shell.

Dado un ShellSurfaceItem con un QtShellSurface asociado, el elemento adaptará automáticamente su tamaño para ajustarse a la superficie. También proporcionará un manejo automático de:

• Estados de ventana, como maximizado, minimizado y pantalla completa.
• Activación de ventanas.
• Cambio de tamaño de la ventana mediante los tiradores de cambio de tamaño (si se establecen las propiedades adecuadas).
• Reposicionamiento de la ventana usando la interacción con la barra de título (si la propiedad titleBar está establecida.)

QtShellChrome está pensado para ser usado junto con QtShell y QtShellSurface.

Ver también QtShell Compositor.

Documentación de Propiedades

bottomLeftResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento inferior izquierdo por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo sus bordes inferior e izquierdo en cantidades iguales.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: blrh
       anchors.bottom: parent.bottom
       anchors.left: parent.left
       height: 5
       width: 5
       color: "white"
   }
   bottomLeftResizeHandle: blrh
}

bottomResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento inferior por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo su borde inferior.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de la ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: brh
       anchors.bottom: parent.bottom
       anchors.left: parent.left
       anchors.right: parent.right
       height: 5
       color: "white"
   }
   bottomResizeHandle: brh
}

bottomRightResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento inferior derecho por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo sus bordes inferior y derecho en cantidades iguales.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: brrh
       anchors.bottom: parent.bottom
       anchors.right: parent.right
       height: 5
       width: 5
       color: "white"
   }
   bottomRightResizeHandle: brrh
}

frameMarginBottom : int

Establece el tamaño del margen inferior de QtShellChrome que se reserva para las decoraciones de la ventana. Por defecto, será igual a la altura de bottomResizeHandle si está configurado. En caso contrario, será 0.

frameMarginLeft : int

Establece el tamaño del margen izquierdo de QtShellChrome que se reserva para las decoraciones de la ventana. Por defecto, será igual a la anchura de leftResizeHandle si está configurado. En caso contrario, será 0.

frameMarginRight : int

Establece el tamaño del margen derecho de QtShellChrome que se reserva para las decoraciones de la ventana. Por defecto, será igual a la anchura de rightResizeHandle si está configurado. En caso contrario, será 0.

frameMarginTop : int

Establece el tamaño del margen superior de QtShellChrome que se reserva para las decoraciones de la ventana. Por defecto, será igual a la suma de las alturas de leftResizeHandle y titleBar, si están definidas. En caso contrario, será 0.

hasDecorations : bool [read-only]

Esta propiedad es verdadera si las decoraciones de QtShellChrome deben ser visibles, basándose en su estado y en los indicadores de ventana.

leftResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento izquierdo por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo su borde izquierdo.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de la ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: lrh
       anchors.left: parent.left
       anchors.top: parent.top
       anchors.bottom: parent.bottom
       width: 5
       color: "white"
   }
   leftResizeHandle: lrh
}

maximizedRect : rect

Esta propiedad contiene el área de WaylandOutput que está disponible para ser rellenada por la ventana cuando está en estado maximizado. Por defecto, la ventana ocupará toda la geometría de WaylandOutput cuando esté maximizada. Cambiarlo puede ser útil, por ejemplo, cuando el compositor tiene otra interfaz de usuario del sistema que no debe ser oscurecida por las aplicaciones maximizadas, como una barra de tareas.

rightResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento derecho por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo su borde derecho.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de la ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: rrh
       anchors.right: parent.right
       anchors.top: parent.top
       anchors.bottom: parent.bottom
       width: 5
       color: "white"
   }
   rightResizeHandle: rrh
}

shellSurfaceItem : ShellSurfaceItem

Esta propiedad contiene el elemento de la superficie del caparazón asociado a este QtShellChrome. A su vez, gestionará el shellSurface de este elemento. Se espera que el shellSurface del elemento sea del tipo QtShellSurface.

QtShellChrome {
   id: chrome
   ShellSurfaceItem {
       id: sfi
       anchors.fill: parent
       moveItem: chrome
   }
   shellSurfaceItem: sfi
}

titleBar : Item

Esta propiedad contiene el elemento predeterminado de la barra de título de QtShellChrome. Si se establece, se instalará un DragHandler en la barra de título que mueve la ventana al interactuar con el usuario. Además, la ventana se activará automáticamente si se hace clic en la barra de título.

La barra de título se ocultará y mostrará automáticamente, dependiendo de las banderas de la ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: tb
       anchors.top: parent.top
       anchors.right: parent.right
       anchors.left: parent.left
       height: 50
       color: "black"

       Text {
           color: "white"
           anchors.centerIn: parent
           text: shellSurfaceItem.shellSurface.windowTitle
           font.pixelSize: 25
       }
   }
   titleBar: tb
}

topLeftResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento superior izquierdo por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo sus bordes superior e izquierdo en cantidades iguales.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: tlrh
       anchors.top: parent.top
       anchors.left: parent.left
       height: 5
       width: 5
       color: "white"
   }
   topLeftResizeHandle: tlrh
}

topResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento superior por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo su borde superior.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de la ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: trh
       anchors.top: parent.top
       anchors.left: parent.left
       anchors.right: parent.right
       height: 5
       color: "white"
   }
   topResizeHandle: trh
}

topRightResizeHandle : Item

Esta propiedad contiene el manejador de redimensionamiento superior derecho por defecto de QtShellChrome. Si se establece, se instalará un DragHandler en el manejador de redimensionamiento que redimensiona la ventana moviendo sus bordes superior y derecho en cantidades iguales.

El manejador se ocultará y mostrará automáticamente, dependiendo de las banderas de ventana y del estado de pantalla completa de la ventana.

QtShellChrome {
   Rectangle {
       id: trrh
       anchors.top: parent.top
       anchors.right: parent.right
       height: 5
       width: 5
       color: "white"
   }
   topRightResizeHandle: trrh
}

windowFlags : int [read-only]

Esta propiedad contiene los indicadores de ventana de QtShellChrome. Coincidirán con la propiedad windowFlags de QtShellSurface, excepto cuando ésta sea igual a Qt.Window. En este caso, se utilizará un conjunto de indicadores de ventana por defecto. Los indicadores de ventana por defecto son Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint y Qt.WindowCloseButtonHint.

windowState : int [read-only]

Esta propiedad contiene el estado de la ventana de la superficie de la carcasa. Se actualizará inmediatamente cuando se solicite el estado de la ventana en el lado del compositor, antes de que el cliente lo confirme. Por lo tanto, puede diferir brevemente de la propiedad windowState de la superficie de la carcasa, que se actualizará cuando el cliente haya reconocido la solicitud.

Documentación del método

void activate()

Active manualmente esta ventana. Esto también levantará la ventana.

Véase también raise().

void deactivate()

Desactiva manualmente esta ventana. Si la ventana estaba activa, se activará la siguiente ventana de la pila.

void lower()

Baje esta ventana, de modo que se apile debajo de otras ventanas (excepto si las banderas de ventana de la otra ventana lo prohíben).

void raise()

Eleva esta ventana para que se apile sobre otras ventanas (excepto si las banderas de las otras ventanas lo prohíben).

void toggleFullScreen()

Alterna entre los estados de pantalla completa y ventana normal. Este método también borra los estados de ventana minimizada o maximizada si alguno de ellos está activado.

void toggleMaximized()

Alterna entre los estados maximizado y normal. Este método también borra el estado minimizado de la ventana si está configurado.

void toggleMinimized()

Alterna entre los estados minimizado y normal. Este método también borra el estado maximizado de la ventana si está configurado.