Auf dieser Seite

Qt Quick Templates 2 QML Types

Das Modul „Qt Quick Templates 2“ stellt eine Reihe nicht-visueller Vorlagen bereit, mit denen sich Benutzeroberflächenelemente in QML mithilfe von Qt Quick.

Diese Typen sollten verwendet werden, wenn Sie ein Steuerelement von Grund auf neu implementieren möchten, anstatt ein bestehendes Steuerelement anzupassen. Dies ist am häufigsten der Fall, wenn Sie einen benutzerdefinierten Stil erstellen.

Die QML-Typen können mithilfe der folgenden Importanweisung in Ihre „ .qml “-Datei importiert werden:

import QtQuick.Templates as T

Es besteht eine Eins-zu-Eins-Zuordnung zwischen den Typen, die durch die Importe „ QtQuick.Templates “ und „ QtQuick.Controls “ bereitgestellt werden. Für jeden im Import „ QtQuick.Controls “ verfügbaren Typ existiert im Import „ QtQuick.Templates “ ein gleichnamiger nicht-visueller Vorlagentyp.

Hinweis: Es wird empfohlen, für den „templates“-Import einen Namespace zu verwenden, um Überschneidungen mit den vom Import „ QtQuick.Controls “ bereitgestellten Typen zu vermeiden.

QML-Typen

AbstractButton

Abstrakter Basistyp, der Funktionen bereitstellt, die allen Schaltflächen gemeinsam sind

Action

Abstrakte Benutzeroberflächenaktion

ActionGroup

Gruppiert Aktionen

ApplicationWindow

Gestaltetes Fenster der obersten Ebene mit Unterstützung für Kopf- und Fußzeile

BusyIndicator

Zeigt Hintergrundaktivitäten an, beispielsweise während Inhalte geladen werden

Button

Druckknopf, der angeklickt werden kann, um einen Befehl auszuführen oder eine Frage zu beantworten

ButtonGroup

Sich gegenseitig ausschließende Gruppe von aktivierbaren Schaltflächen

Calendar

Ein Kalender-Namespace

CalendarModel

Ein Kalendermodell

CheckBox

Kontrollkästchen, das ein- oder ausgeschaltet werden kann

CheckDelegate

Element-Delegat mit einem Kontrollkästchen, das ein- oder ausgeschaltet werden kann

ComboBox

Kombination aus Schaltfläche und Popup-Liste zur Auswahl von Optionen

Container

Abstrakter Basistyp, der für Container gemeinsame Funktionen bereitstellt

ContextMenu

Der angehängte Typ bietet eine Möglichkeit, ein Kontextmenü plattformgerecht zu öffnen

Control

Abstrakter Basistyp, der allen Steuerelementen gemeinsame Funktionen bereitstellt

DayOfWeekRow

Eine Zeile mit den Namen der Wochentage

DelayButton

Kontrollkästchen, das bei ausreichend langem Drücken ausgelöst wird

Dial

Ein Drehregler, der zur Einstellung eines Werts gedreht wird

Dialog

Popup-Dialogfeld mit Standardschaltflächen und einem Titel, das für die kurzfristige Interaktion mit dem Benutzer verwendet wird

DialogButtonBox

Ein Schaltflächenfeld, das in Dialogen verwendet wird

DoubleSpinBox

Ermöglicht dem Benutzer die Auswahl aus einer Reihe voreingestellter Gleitkommawerte

Drawer

Seitenleiste, die durch eine Wischgeste geöffnet und geschlossen werden kann

Frame

Visueller Rahmen für eine logische Gruppe von Steuerelementen

GroupBox

Visueller Rahmen und Titel für eine logische Gruppe von Steuerelementen

HorizontalHeaderView

Stellt eine horizontale Kopfzeilenansicht als Ergänzung zu einer TableView bereit

HorizontalHeaderViewDelegate

ItemDelegate

Einfacher Element-Delegat, der in verschiedenen Ansichten und Steuerelementen verwendet werden kann

Label

Gestaltete Textbeschriftung mit vererbter Schriftart

Menu

Popup, das als Kontextmenü oder Popup-Menü verwendet werden kann

MenuBar

Stellt eine Fenster-Menüleiste bereit

MenuBarItem

Zeigt ein Dropdown-Menü innerhalb einer Menüleiste an

MenuItem

Zeigt ein Element innerhalb eines Menüs an

MenuSeparator

Trennt eine Gruppe von Menüpunkten von benachbarten Menüpunkten

MonthGrid

Ein Raster mit Tagen für einen Kalendermonat

Overlay

Eine Fensterüberlagerung für Popups

Page

Gestaltetes Seitensteuerelement mit Unterstützung für Kopf- und Fußzeile

PageIndicator

Zeigt die aktuell aktive Seite an

Pane

Stellt einen Hintergrund bereit, der zum Stil und Thema der Anwendung passt

Popup

Basistyp für Popup-ähnliche Benutzeroberflächensteuerelemente

ProgressBar

Zeigt den Fortschritt eines Vorgangs an

RadioButton

Exklusives Optionsfeld, das ein- oder ausgeschaltet werden kann

RadioDelegate

Exklusiver Element-Delegat mit einem Radio-Indikator, der ein- oder ausgeschaltet werden kann

RangeSlider

Dient zur Auswahl eines Wertebereichs durch Verschieben zweier Schieberegler entlang einer Schiene

RoundButton

Ein Drucktaste-Steuerelement mit abgerundeten Ecken, auf das der Benutzer klicken kann

ScrollBar

Vertikale oder horizontale interaktive Bildlaufleiste

ScrollIndicator

Vertikaler oder horizontaler, nicht interaktiver Bildlaufindikator

ScrollView

Scrollbare Ansicht

SearchField

Ein spezielles Eingabefeld, das für Suchfunktionen vorgesehen ist

SelectionRectangle

Wird verwendet, um Tabellenzellen innerhalb einer TableView auszuwählen

Slider

Dient zur Auswahl eines Werts durch Verschieben eines Schiebereglers entlang einer Schiene

SpinBox

Ermöglicht dem Benutzer die Auswahl aus einer Reihe voreingestellter Werte

SplitHandle

Stellt angehängte Eigenschaften für SplitView-Schieberegler bereit

SplitView

Ordnet Elemente mit einem verschiebbaren Trennbalken zwischen den einzelnen Elementen an

StackView

Stellt ein stapelbasiertes Navigationsmodell bereit

SwipeDelegate

Delegat für wischbare Elemente

SwipeView

Ermöglicht dem Benutzer die Navigation durch Seiten durch seitliches Wischen

Switch

Schaltfläche, die ein- und ausgeschaltet werden kann

SwitchDelegate

Element-Delegat mit einer Umschaltanzeige, die ein- und ausgeschaltet werden kann

TabBar

Ermöglicht dem Benutzer das Wechseln zwischen verschiedenen Ansichten oder Teilaufgaben

TabButton

Schaltfläche mit einem für eine TabBar geeigneten Design

TableViewDelegate

Ein Delegat, der einer TableView zugewiesen werden kann

TextArea

Mehrzeiliges Texteingabefeld

TextField

Einzeiliges Texteingabefeld

ToolBar

Container für kontextsensitive Steuerelemente

ToolButton

Schaltfläche mit einem für eine ToolBar geeigneten Erscheinungsbild

ToolSeparator

Trennt eine Gruppe von Elementen in einer Symbolleiste von benachbarten Elementen

ToolTip

Stellt Tooltips für jedes Steuerelement bereit

TreeViewDelegate

Ein Delegat, der einer TreeView zugewiesen werden kann

Tumbler

Drehbares Rad mit auswählbaren Elementen

VerticalHeaderView

Bietet eine vertikale Kopfzeilenansicht als Ergänzung zu einem TableView

VerticalHeaderViewDelegate

WeekNumberColumn

Eine Spalte mit Wochennummern

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.