?? moc.html
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-win-commercial-3.0.5/doc/moc.doc:39 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>使用元對象編譯器</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主頁</font></a>
| <a href="classes.html">
<font color="#004faf">所有的類</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的類</font></a>
| <a href="annotated.html">
<font color="#004faf">注釋的類</font></a>
| <a href="groups.html">
<font color="#004faf">分組的類</font></a>
| <a href="functions.html">
<font color="#004faf">函數</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>使用元對象編譯器</h1>
<p> <!-- index moc --><a name="moc"></a>
<p> 元對象編譯器，朋友中的moc，是處理Qt的<a href="metaobjects.html">C++擴展</a>的程序。
<p> 元對象編譯器讀取一個C++源文件。如果它發現其中的一個或多個類的聲明中含有<a href="metaobjects.html#Q_OBJECT">Q_OBJECT</a>宏，它就會給這個使用Q_OBJECT宏的類生成另外一個包含<a href="metaobjects.html#meta-object">元對象</a>代碼的C++源文件。尤其是，元對象代碼對信號/槽機制、運行時類型信息和動態屬性系統是需要的。
<p> 一個被元對象編譯器生成的C++源文件必須和這個類的實現一起被編譯和連接（或者它被包含到（#include）這個類的源文件中）。
<p> 如果你是用<a href="qmake-manual.html">qmake</a>來生成你的Makefile文件，當需要的時候，編譯規則中需要包含調用元對象編譯器，所以你不需要直接使用元對象編譯器。關于元對象編譯器的更多的背景知識，請看<a href="templates.html">為什么Qt不用模板來實現信號和槽？</a>。
<p> <h2> 用法
</h2>
<a name="1"></a><p> 元對象編譯器很典型地和包含下面這樣情況地類聲明地輸入文件一起使用：
<p> <pre>
class MyClass : public <a href="qobject.html">QObject</a>
{
Q_OBJECT
public:
MyClass( <a href="qobject.html">QObject</a> * parent=0, const char * name=0 );
~MyClass();
signals:
void mySignal();
public slots:
void mySlot();
};
</pre>
<p> 除了上述提到地信號和槽，元對象編譯器在下一個例子中還將實現對象屬性。Q_PROPERTY宏聲明了一個對象屬性，而Q_ENUMS 聲明在這個類中的<a href="properties.html">屬性系統</a>中可用的枚舉類型的一個列表。在這種特殊的情況下，我們聲明了一個枚舉類型屬性<tt>Priority</tt>，也被稱為“priority”，并且讀函數為<tt>priority()</tt>，寫函數為<tt>setPriority()</tt>。
<p> <pre>
class MyClass : public <a href="qobject.html">QObject</a>
{
Q_OBJECT
Q_PROPERTY( Priority priority READ priority WRITE setPriority )
Q_ENUMS( Priority )
public:
MyClass( <a href="qobject.html">QObject</a> * parent=0, const char * name=0 );
~MyClass();
enum Priority { High, Low, VeryHigh, VeryLow };
void setPriority( Priority );
Priority priority() const;
};
</pre>
<p> 屬性可以通過Q_OVERRIDE宏在子類中進行修改。Q_SETS宏聲明了枚舉變量可以進行組合操作，也就是說可以一起讀或寫。另外一個宏，Q_CLASSINFO，用來給類的元對象添加名稱/值這樣一組數據：
<p> <pre>
class MyClass : public <a href="qobject.html">QObject</a>
{
Q_OBJECT
Q_CLASSINFO( "Author", "Oscar Peterson")
Q_CLASSINFO( "Status", "Very nice class")
public:
MyClass( <a href="qobject.html">QObject</a> * parent=0, const char * name=0 );
~MyClass();
};
</pre>
<p> 這三個概念：信號和槽、屬性和元對象數據是可以組合在一起的。
<p> 元對象編譯器生成的輸出文件必須被編譯和連接，就像你的程序中的其它的C++代碼一樣；否則你的程序的連編將會在最后的連接階段失敗。出于習慣，這種操作是用下述兩種方式之一解決的：
<p> <dl>
<p> <dt><b>方法一：類的聲明放在一個頭文件（<em>.h文件</em>）中</b>
<p> <dd>如果在上述的文件<em>myclass.h</em>中發現類的聲明，元對象編譯器的輸出文件將會被放在一個叫<em>moc_myclass.cpp</em>的文件中。這個文件將會像通常情況一樣被編譯，作為對象文件的結果是<em>moc_myclass.o</em>（在Unix下）或者<em>moc_myclass.obj</em>（在Windows下）。這個對象接著將會被包含到一個對象文件列表中，它們將會在程序的最后連編階段被連接在一起。
<p> <dt><b>方法二：類的聲明放在一個實現文件（<em>.cpp文件</em>）中</b>
<p> <dd>如果上述的文件<em>myclass.cpp</em>中發現類的聲明，元對象編譯器的輸出文件將會被放在一個叫<em>myclass.moc</em>的文件中。這個文件需要被實現文件包含（#include），也就是說<em>myclass.cpp</em>需要包含下面這行
<pre>
#include "myclass.moc"
</pre>
放在所有的代碼之后。這樣，元對象編譯器生成的代碼將會和<em>myclass.cpp</em>中普通的類定義一起被編譯和連接，所以方法一中的分別編譯和連接就是不需要的了。
<p> </dl>
方法一是常規的方法。方法二用在你想讓實現文件自包含，或者Q_OBJECT類是內部實現的并且在頭文件中不可見的這些情況下使用。
<p> <h2> Makefile中自動使用元對象編譯器的方法
</h2>
<a name="2"></a><p> 除了最簡單的測試程序之外的任何程序，建議自動使用元對象編譯器。在你的程序的Makefile文件中加入一些規則，<em>make</em>就會在需要的時候運行元對象編譯器和處理元對象編譯器的輸出。
<p> 我們建議使用Trolltech的自由makefile生成工具，<a href="qmake-manual.html">qmake</a>，來生成你的Makefile。這個工具可以識別方法一和方法二風格的源文件，并建立一個可以做所有必要的元對象編譯操作的Makefile。
<p> 另一方面如果，你想自己建立你的Makefile，下面是如何包含元對象編譯操作的一些提示。
<p> 對于在頭文件中聲明了Q_OBJECT宏的類，如果你只使用GNU的make的話，這是一個很有用的makefile規則：
<p> <pre>
moc_%.cpp: %.h
moc $< -o $@
</pre>
<p> 如果你想更方便地寫makefile，你可以按下面的格式寫單獨的規則：
<p> <pre>
moc_NAME.cpp: NAME.h
moc $< -o $@
</pre>
<p> 你必須記住要把<em>moc_NAME.cpp</em>添加到你的SOURCES（你可以用你喜歡的名字替代）變量中并且把<em>moc_NAME.o</em>或者<em>moc_NAME.obj</em>添加到你的OBJECTS變量中。
<p> （當我們給我們的C++源文件命名為.cpp時，元對象編譯器并不留意，所以只要你喜歡，你可以使用.C、.cc、.CC、.cxx或者甚至.c++。）
<p> 對于在實現文件（.cpp文件）中聲明Q_OBJECT的類，我們建議你使用下面這樣的makefile規則：
<p> <pre>
NAME.o: NAME.moc
NAME.moc: NAME.cpp
moc -i $< -o $@
</pre>
<p> 這將會保證make程序會在編譯<em>NAME.cpp</em>之前運行元對象編譯器。然后你可以把
<p> <pre>
#include "NAME.moc"
</pre>
<p> 放在<em>NAME.cpp</em>的末尾，這樣在這個文件中的所有的類聲明被完全地知道。
<p> <h2> 調用元對象編譯器moc
</h2>
<a name="3"></a><p> 這里是元對象編譯器moc所支持地命令行選項：
<p> <dl>
<dt> -o <em>file</em> <dd> 將輸出寫到<em>file</em>而不是標準輸出。
<dt> -f <dd> 強制在輸出文件中生成#include聲明。文件的名稱必須符合<a href="qregexp.html#regular-expression">正則表達式</a>\.[hH][^.]*（也就是說擴展名必須以H或h開始）。這個選項只有在你的頭文件沒有遵循標準命名法則的時候才有用。
<dt> -i <dd> 不在輸出文件中生成#include聲明。當一個C++文件包含一個或多個類聲明的時候你也許應該這樣使用元對象編譯器。然后你應該在.cpp文件中包含（#include）元對象代碼。如果-i和-f兩個參數都出現，后出現的有效。
<dt> -nw <dd> 不產生任何警告。不建議使用。
<dt> -ldbg <dd> 把大量的lex調試信息寫到標準輸出。
<dt> -p <em>path</em> <dd> 使元對象編譯器生成的（如果有生成的）#include聲明的文件名稱中預先考慮到<em>path</em>/。
<dt> -q <em>path</em> <dd> 使元對象編譯器在生成的文件中的qt #include文件的名稱中預先考慮到<em>path</em>/。
</dl>
<p> 你可以明確地告訴元對象編譯器不要解析頭文件中的成分。它可以識別包含子字符串MOC_SKIP_BEGIN或者MOC_SKIP_END的任何C++注釋（//）。它們正如你所期望的那樣工作并且你可以把它們劃分為若干層次。元對象編譯器所看到的最終結果就好像你把一個MOC_SKIP_BEGIN和一個MOC_SKIP_END當中的所有行刪除那樣。
<p> <h2> 診斷
</h2>
<a name="4"></a><p> 元對象編譯器將會警告關于學多在Q_OBJECT類聲明中危險的或者不合法的構造。
<p> 如果你在你的程序的最后連編階段得到連接錯誤，說YourClass::className()是未定義的或者YourClass缺乏vtbl，某樣東西已經被做錯。絕大多數情況下，你忘記了編譯或者#include元對象編譯器產生的C++代碼，或者（在前面的情況下）沒有在連接命令中包含那個對象文件。
<p> <h2> 限制
</h2>
<a name="5"></a><p> 元對象編譯器并不展開#include或者#define，它簡單地忽略它所遇到的所有預處理程序指示。這是遺憾的，但是在實踐中它通常情況下不是問題。
<p> 元對象編譯器不處理所有的C++。主要的問題是類模板不能含有信號和槽。這里是一個例子：
<p> <pre>
class SomeTemplate<int> : public <a href="qframe.html">QFrame</a> {
Q_OBJECT
...
signals:
void bugInMocDetected( int );
};
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -