<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- object.qdoc -->
<title>Qt 4.8: Object Model</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li>Object Model</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#important-classes">Important Classes</a></li>
<li class="level1"><a href="#qt-objects-identity-vs-value">Qt Objects: Identity vs Value</a></li>
</ul>
</div>
<h1 class="title">Object Model</h1>
<span class="subtitle"></span>
<!-- $$$object.html-description -->
<div class="descr"> <a name="details"></a>
<p>The standard C++ object model provides very efficient runtime support for the object paradigm. But its static nature is inflexibile in certain problem domains. Graphical user interface programming is a domain that requires both runtime efficiency and a high level of flexibility. Qt provides this, by combining the speed of C++ with the flexibility of the Qt Object Model.</p>
<p>Qt adds these features to C++:</p>
<ul>
<li>a very powerful mechanism for seamless object communication called <a href="signalsandslots.html#signals-and-slots">signals and slots</a></li>
<li>queryable and designable <a href="properties.html#qt-s-property-system">object properties</a></li>
<li>powerful <a href="eventsandfilters.html">events and event filters</a></li>
<li>contextual <a href="i18n.html">string translation for internationalization</a></li>
<li>sophisticated interval driven <a href="timers.html">timers</a> that make it possible to elegantly integrate many tasks in an event-driven GUI</li>
<li>hierarchical and queryable <a href="objecttrees.html">object trees</a> that organize object ownership in a natural way</li>
<li>guarded pointers (<a href="qpointer.html">QPointer</a>) that are automatically set to 0 when the referenced object is destroyed, unlike normal C++ pointers which become dangling pointers when their objects are destroyed</li>
<li>a <a href="metaobjects.html#qobjectcast">dynamic cast</a> that works across library boundaries.</li>
</ul>
<p>Many of these Qt features are implemented with standard C++ techniques, based on inheritance from <a href="qobject.html">QObject</a>. Others, like the object communication mechanism and the dynamic property system, require the <a href="metaobjects.html#meta-object-system">Meta-Object System</a> provided by Qt's own <a href="moc.html#moc">Meta-Object Compiler (moc)</a>.</p>
<p>The meta-object system is a C++ extension that makes the language better suited to true component GUI programming. Although templates can be used to extend C++, the meta-object system provides benefits using standard C++ that cannot be achieved with templates; see <a href="templates.html">Why Doesn't Qt Use Templates for Signals and Slots?</a></p>
<a name="important-classes"></a>
<h2>Important Classes</h2>
<p>These classes form the basis of the Qt Object Model.</p>
<table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qmetaclassinfo.html">QMetaClassInfo</a></p></td><td class="tblDescr"><p>Additional information about a class</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qmetaenum.html">QMetaEnum</a></p></td><td class="tblDescr"><p>Meta-data about an enumerator</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qmetamethod.html">QMetaMethod</a></p></td><td class="tblDescr"><p>Meta-data about a member function</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qmetaobject.html">QMetaObject</a></p></td><td class="tblDescr"><p>Contains meta-information about Qt objects</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qmetaproperty.html">QMetaProperty</a></p></td><td class="tblDescr"><p>Meta-data about a property</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qmetatype.html">QMetaType</a></p></td><td class="tblDescr"><p>Manages named types in the meta-object system</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qobject.html">QObject</a></p></td><td class="tblDescr"><p>The base class of all Qt objects</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qobjectcleanuphandler.html">QObjectCleanupHandler</a></p></td><td class="tblDescr"><p>Watches the lifetime of multiple QObjects</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qpointer.html">QPointer</a></p></td><td class="tblDescr"><p>Template class that provides guarded pointers to QObject</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsignalmapper.html">QSignalMapper</a></p></td><td class="tblDescr"><p>Bundles signals from identifiable senders</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qvariant.html">QVariant</a></p></td><td class="tblDescr"><p>Acts like a union for the most common Qt data types</p></td></tr>
</table>
<a name="identity-vs-value"></a><a name="qt-objects-identity-vs-value"></a>
<h2>Qt Objects: Identity vs Value</h2>
<p>Some of the added features listed above for the Qt Object Model, require that we think of Qt Objects as identities, not values. Values are copied or assigned; identities are cloned. Cloning means to create a new identity, not an exact copy of the old one. For example, twins have different identities. They may look identical, but they have different names, different locations, and may have completely different social networks.</p>
<p>Then cloning an identity is a more complex operation than copying or assigning a value. We can see what this means in the Qt Object Model.</p>
<p><b>A Qt Object...</b></p>
<ul>
<li>might have a unique <a href="qobject.html#objectName-prop">QObject::objectName</a>(). If we copy a Qt Object, what name should we give the copy?</li>
<li>has a location in an <a href="objecttrees.html">object hierarchy</a>. If we copy a Qt Object, where should the copy be located?</li>
<li>can be connected to other Qt Objects to emit signals to them or to receive signals emitted by them. If we copy a Qt Object, how should we transfer these connections to the copy?</li>
<li>can have <a href="properties.html#qt-s-property-system">new properties</a> added to it at runtime that are not declared in the C++ class. If we copy a Qt Object, should the copy include the properties that were added to the original?</li>
</ul>
<p>For these reasons, Qt Objects should be treated as identities, not as values. Identities are cloned, not copied or assigned, and cloning an identity is a more complex operation than copying or assigning a value. Therefore, <a href="qobject.html">QObject</a> and all subclasses of <a href="qobject.html">QObject</a> (direct or indirect) have their <a href="qobject.html#no-copy-constructor">copy constructor and assignment operator</a> disabled.</p>
</div>
<!-- @@@object.html -->
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
