QSignalMapper Class Reference · PyQt4 中文文檔

# QSignalMapper Class Reference ## [[QtCore](index.htm) module] 該QSignalMapper捆綁類的個別發件人的信號。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `map (self)` * `map (self, QObject?sender)` * `QObject mapping (self, int?id)` * `QObject mapping (self, QString?text)` * `QObject mapping (self, QWidget?widget)` * `QObject mapping (self, QObject?object)` * `removeMappings (self, QObject?sender)` * `setMapping (self, QObject?sender, int?id)` * `setMapping (self, QObject?sender, QString?text)` * `setMapping (self, QObject?sender, QWidget?widget)` * `setMapping (self, QObject?sender, QObject?object)` ### Qt Signals * `void mapped (int)` * `void mapped (const QString&)` * `void mapped (QWidget *)` * `void mapped (QObject *)` * * * ## Detailed Description 該QSignalMapper捆綁類的個別發件人的信號。此類采集一組參數的信號，并重新發射它們與整型，字符串或對應于發送該信號的插件對象的參數。這個類支持使用特定的字符串或整數與特定對象的映射[setMapping](qsignalmapper.html#setMapping)（）。的對象的信號可以被連接到[map](qsignalmapper.html#map)（）槽，將放出[mapped](qsignalmapper.html#mapped)（）信號與原信號的對象相關聯的字符串或整數。映射可以在以后使用中刪除[removeMappings](qsignalmapper.html#removeMappings)（）。例如：假設我們要創建一個包含一組按鈕（如工具選項板）的自定義窗口小部件。一種方法是在連接各個按鈕的`clicked()`信號到其自己的定制插槽，但在這個例子中，我們希望所有的按鈕連接到一個單一的插槽，并通過單擊的按鈕，參數化的插槽。下面是一個簡單的自定義窗口小部件，有一個單一信號的定義，`clicked()`，這是發射與被點擊的按鈕的文本： ``` class ButtonWidget : public [QWidget](qwidget.html) { Q_OBJECT public: ButtonWidget([QStringList](qstringlist.html) texts, [QWidget](qwidget.html) *parent = 0); signals: void clicked(const [QString](qstring.html) &text); private: QSignalMapper *signalMapper; }; ``` 我們需要實現的唯一功能是構造函數： ``` ButtonWidget.ButtonWidget([QStringList](qstringlist.html) texts, [QWidget](qwidget.html) *parent) : [QWidget](qwidget.html)(parent) { signalMapper = new QSignalMapper(this); [QGridLayout](qgridlayout.html) *gridLayout = new [QGridLayout](qgridlayout.html); for (int i = 0; i < texts.size(); ++i) { [QPushButton](qpushbutton.html) *button = new [QPushButton](qpushbutton.html)(texts[i]); connect(button, SIGNAL(clicked()), signalMapper, SLOT(map())); signalMapper->setMapping(button, texts[i]); gridLayout->addWidget(button, i / 3, i % 3); } connect(signalMapper, SIGNAL(mapped(const [QString](qstring.html) &)), this, SIGNAL(clicked(const [QString](qstring.html) &))); setLayout(gridLayout); } ``` 文本列表被傳遞給構造函數。信號映射器的構造和在列表中的每個文本[QPushButton](qpushbutton.html)被創建。我們連接每個按鈕的`clicked()`信號到信號映射器的[map](qsignalmapper.html#map)（）槽，并從每個按鈕的信號映射到該按鈕的文本創建一個映射。最后，我們連接信號變換器的[mapped](qsignalmapper.html#mapped)（）信號到自定義widget的`clicked()`信號。當用戶點擊一個按鈕，自定義窗口小部件會發出一個單一的`clicked()`信號，其參數是用戶點擊按鈕的文本。 * * * ## Method Documentation ``` QSignalMapper.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QSignalMapper](qsignalmapper.html)與父_parent_。 ``` QSignalMapper.map (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void map()`。這個插槽發出的信號的基礎上哪個對象發送信號給它。 ``` QSignalMapper.map (self, QObject?sender) ``` 這種方法也是一個Qt槽與C + +的簽名`void map(QObject *)`。這個時隙發射的基礎上，信號_sender_對象。 ``` QObject QSignalMapper.mapping (self, int?id) ``` [](qobject.html) [返回發件人](qobject.html)[QObject](qobject.html)是與相關聯的_id_。 **See also** [setMapping](qsignalmapper.html#setMapping)（）。 ``` QObject QSignalMapper.mapping (self, QString?text) ``` [](qobject.html) [這個函數的重載](qobject.html)[mapping](qsignalmapper.html#mapping)（）。 ``` QObject QSignalMapper.mapping (self, QWidget?widget) ``` [](qobject.html) [這個函數的重載](qobject.html)[mapping](qsignalmapper.html#mapping)（）。返回發件人[QObject](qobject.html)是與相關聯的_widget_。 ``` QObject QSignalMapper.mapping (self, QObject?object) ``` [](qobject.html) [這個函數的重載](qobject.html)[mapping](qsignalmapper.html#mapping)（）。返回發件人[QObject](qobject.html)是與相關聯的_object_。 ``` QSignalMapper.removeMappings (self, QObject?sender) ``` 刪除所有映射_sender_。這是自動完成的，當映射對象被銷毀。 ``` QSignalMapper.setMapping (self, QObject?sender, int?id) ``` 添加一個映射，這樣，當[map](qsignalmapper.html#map)（）被從給定的信號_sender_中，信號映射（_id_）被發射。有可能是對每個發送至多一個整數ID 。 **See also** [mapping](qsignalmapper.html#mapping)（）。 ``` QSignalMapper.setMapping (self, QObject?sender, QString?text) ``` 添加一個映射，這樣，當[map](qsignalmapper.html#map)（）是從信號_sender_中，信號映射（_text_）被發射。可能有最多一個文本為每個發件人。 ``` QSignalMapper.setMapping (self, QObject?sender, QWidget?widget) ``` 添加一個映射，這樣，當[map](qsignalmapper.html#map)（）是從信號_sender_中，信號映射（_widget_）被發射。可能有最多一個部件每個發件人。 ``` QSignalMapper.setMapping (self, QObject?sender, QObject?object) ``` 添加一個映射，這樣，當[map](qsignalmapper.html#map)（）是從信號_sender_中，信號映射（_object_）被發射。可能存在至多一個對象的每個發送者。 * * * ## Qt Signal Documentation ``` void mapped (int) ``` 這是該信號的默認超載。這個信號被發射時[map](qsignalmapper.html#map)（）從一個對象，該對象具有整數的映射集信號。對象的映射整數傳入_i_。 **See also** [setMapping](qsignalmapper.html#setMapping)（）。 ``` void mapped (const QString&) ``` 這個信號被發射時[map](qsignalmapper.html#map)（）從一個對象，它有一個字符串的映射集信號。該對象的字符串映射中傳遞_text_。 **See also** [setMapping](qsignalmapper.html#setMapping)（）。 ``` void mapped (QWidget *) ``` 這個信號被發射時[map](qsignalmapper.html#map)（）從一個對象，它有一個小部件映射集信號。對象的映射部件被傳遞_widget_。 **See also** [setMapping](qsignalmapper.html#setMapping)（）。 ``` void mapped (QObject *) ``` 這個信號被發射時[map](qsignalmapper.html#map)（）從一個對象，該對象具有對象映射集信號。由地圖提供的對象被傳遞_object_。 **See also** [setMapping](qsignalmapper.html#setMapping)（）。