Auf dieser Seite

QtObject QML Type

Ein grundlegender QML-Typ. Mehr...

Import Statement: import QtQml
In C++: QObject
Inherited By:
135 types

AbstractButton, Action, ActionGroup, AllOfFilter, AnimatedImage, AnimatedSprite, AnyOfFilter, BorderImage, BusyIndicator, Button, ButtonGroup, Calendar, Canvas, CheckBox, CheckDelegate, ColorGroup, ColorOpacityAnimation, Column, ColumnLayout, ComboBox, Container, Control, DayOfWeekRow, DelayButton, Dial, Dialog, DialogButtonBox, DoubleSpinBox, Drawer, DropArea, EllipseShape, FilterBase, FlexboxLayout, Flickable, Flipable, Flow, FocusScope, Frame, FunctionFilter, FunctionSorter, Grid, GridLayout, GridView, GroupBox, HorizontalHeaderView, HorizontalHeaderViewDelegate, Image, ImageParticle, Item, ItemDelegate, ItemGrabResult, ItemParticle, Label, LayoutItemProxy, ListView, Loader, MaskShape, Menu, MenuBar, MenuBarItem, MenuItem, MenuSeparator, MonthGrid, MouseArea, MultiEffect, MultiPointTouchArea, Overlay, Page, PageIndicator, Palette, Pane, ParticlePainter, PathView, PinchArea, Popup, ProgressBar, RadioButton, RadioDelegate, RangeFilter, RangeSlider, Rectangle, RectangularShadow, RegExpFilter, Repeater, RoleFilter, RoleSorter, RoundButton, Row, RowLayout, ScrollBar, ScrollIndicator, ScrollView, SearchField, SelectionRectangle, Settings, ShaderEffect, ShaderEffectSource, Shape, Slider, Sorter, SpinBox, SplitHandle, SplitView, SpriteSequence, StackLayout, StackView, StandardPaths, StringSorter, SwipeDelegate, SwipeView, Switch, SwitchDelegate, SystemInformation, TabBar, TabButton, TableView, TableViewDelegate, Text, TextArea, TextEdit, TextField, TextInput, ToolBar, ToolButton, ToolSeparator, ToolTip, TreeView, TreeViewDelegate, Tumbler, ValueFilter, VectorImage, VerticalHeaderView, VerticalHeaderViewDelegate, WeekNumberColumn, and WindowContainer

Eigenschaften

Ausführliche Beschreibung

Der Typ „QtObject“ ist ein nicht-visuelles Element, das ausschließlich die Eigenschaft „ objectName “ enthält.

Es kann nützlich sein, ein QtObject zu erstellen, wenn Sie einen extrem schlanken Typ benötigen, um eine Reihe benutzerdefinierter Eigenschaften zu kapseln:

import QtQuick

Item {
    QtObject {
        id: attributes
        property string name
        property int size
        property variant attributes
    }

    Text { text: attributes.name }
}

Er kann auch für die C++-Integration nützlich sein, da es sich lediglich um ein einfaches ` QObject` handelt. Weitere Details finden Sie in der Dokumentation unter „ QObject “.

Dokumentation zu Eigenschaften

objectName : string

Diese Eigenschaft enthält den „ QObject::objectName “ für diese bestimmte Objektinstanz.

Dadurch kann eine C++-Anwendung mithilfe der Methode „ QObject::findChild()“ ein Element innerhalb einer QML-Komponente lokalisieren. Die folgende C++-Anwendung lokalisiert beispielsweise das untergeordnete Element „ Rectangle “ und ändert dynamisch dessen Wert „ color “:

// MyRect.qml

import QtQuick 2.0

Item {
    width: 200; height: 200

    Rectangle {
        anchors.fill: parent
        color: "red"
        objectName: "myRect"
    }
}
// main.cpp

QQuickView view;
view.setSource(QUrl::fromLocalFile("MyRect.qml"));
view.show();

QQuickItem *item = view.rootObject()->findChild<QQuickItem*>("myRect");
if (item)
    item->setProperty("color", QColor(Qt::yellow));

© 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.