qt-映射器-键盘的应用

 在程序中,通常一个按键被点击时,都会自动调用其相应的槽函数,这就不可避免地需要为每个按键定义一个槽函数。而当这些按键功能相近时,可以考虑使用一个槽函数来响应所有的按键点击信号,这可以避免定义过多的槽函数带来的累赘。但这产生了一个问题,即当多个信号与同一槽函数相连接,在信号触发时,槽函数并不能识别信号究竟是哪个按键触发的。

          以下程序展示一个数字键盘来阐述信号映射的原理:

numerickeypad.h

[cpp]  view plain copy

1. #ifndef _NUMERICKEYPAD_H_  
2. #define _NUMERICKEYPAD_H_  
3.   
4. #include <QWidget>  
5.   
6. class QPushButton;  
7. class QLineEdit;  
8.   
9. class NumericKeypad : public QWidget  
10. {  
11.     Q_OBJECT  
12.       
13.  public:  
14.     NumericKeypad( QWidget * = 0 );  
15.   
16.  private slots:  
17.     void keyClicked( const QString & );  
18.     void setText( const QString & );  
19.   
20.  signals:  
21.     void textChanged( const QString & );  
22.       
23.  private:  
24.     QList< QPushButton * > keys;  
25.     QList< QString > allKeySymbol;  
26.     QString m_text;  
27.     QLineEdit *lineEdit;  
28. };  
29.   
30. #endif   

          

          为创建数字键盘,通常的做法是将所有的按键放在 QGridLayout中:

[cpp]  view plain copy

1. layout->addWidget( key1, 0, 0 );  
2. layout->addWidget( key2, 0, 1 );  
3. ...  
4. layout->addWidget( key0, 3, 1 );  
5. layout->addWidget( keyClear, 3, 2 );  

            另一种做法则便捷一些，将与按键相对应的所有 QString保存在QList< QString > 对象allKeySymbol中。再利用循环将按键加进QGridLayout中。

[cpp]  view plain copy

1. ...   
2. for( int r = 0; r < 4; ++r )  
3.    for( int c  = 0; c < 3; ++c )  
4.    {  
5.       QString keySymbol = allKeySymbol.at( r * 3 + c );  
6.       QPushButton *key = new QPushButton( keySymbol );  
7.       layout->addWidget( key, r, c );  
8.       keys.append( key );  
9.       ...  
10.    }  
11. ...  

            其中，keys为QList< QPushButton * >对象，用来保存所有的按键。

完整的代码：

numerickeypad.cpp

[cpp]  view plain copy

1. #include "numerickeypad.h"  
2. #include <QtGui>  
3.   
4. NumericKeypad::NumericKeypad( QWidget *parent )  
5.     :QWidget( parent )  
6. {  
7.     allKeySymbol << "1" << "2" << "3"  
8.                  << "4" << "5" << "6"  
9.                  << "7" << "8" << "9"  
10.                  << "." << "0" << "C";  
11.       
12.     QGridLayout *layout = new QGridLayout;  
13.     QSignalMapper *mapper = new QSignalMapper( this );  
14.       
15.     for( int r = 0; r < 4; ++r )  
16.         for( int c  = 0; c < 3; ++c )  
17.         {  
18.             QString keySymbol = allKeySymbol.at( r * 3 + c );  
19.             QPushButton *key = new QPushButton( keySymbol );  
20.             keys.append( key );  
21.             layout->addWidget( key, r, c );  
22.             mapper->setMapping( key, keySymbol );  
23.         }  
24.      
25.     foreach( QPushButton *key, keys )  
26.         connect( key, SIGNAL( clicked() ), mapper, SLOT( map() ) );  
27.       
28.     connect( mapper, SIGNAL( mapped( QString ) ),  
29.              this, SLOT( keyClicked( QString ) ) );  
30.   
31.     lineEdit = new QLineEdit;  
32.     lineEdit->setAlignment( Qt::AlignRight );  
33.     lineEdit->setReadOnly( true );  
34.       
35.     QVBoxLayout *mainLayout = new QVBoxLayout( this );  
36.     mainLayout->addWidget( lineEdit );  
37.     mainLayout->addLayout( layout );  
38. }  
39.   
40. void NumericKeypad::keyClicked( const QString &newText )  
41. {  
42.     if( newText == "C" )  
43.         setText( "" );  
44.     else  
45.         setText( m_text + newText );  
46. }  
47.   
48. void NumericKeypad::setText( const QString &text )  
49. {  
50.     if( text == m_text )  
51.         return;  
52.   
53.     m_text = text;  
54.     lineEdit->setText( text );  
55.       
56.     emit textChanged( m_text );  
57. }  

         创建按键的信号映射：

• 调用QSignalMapper的setMapping( QObject *, const QString & )函数，将按键与相应的QString映射起来。
• 在所有按键与QString的映射建立起来之后，将按键的clicked()信号与QSignalMapper的map()槽函数连接。
• 将QSignalMapper的mapped( const QString & )信号与this的槽函数keyClicked( const QString & )连接。

          当某一按键被点击时，其clicked()信号发送时，导致QSignalMapper的槽函数map()被调用，这将会引起QSignalMapper的信号mapped( const QString &)被发送，这个信号将与按键对应的QString对象作为参数发送给this的keyClicked( const QString & )槽函数。这样，keyClicked就能根据接收到的QString的内容来判断发送信号的是哪一个按键了。

          当按下的键是 C 时,将会清空QLineEdit显示的文本。

main.cpp

[cpp]  view plain copy

1. #include "numerickeypad.h"  
2. #include <QApplication>  
3.   
4. int main(int argc, char **argv )  
5. {  
6.     QApplication app( argc, argv );  
7.   
8.     NumericKeypad keypad;  
9.     keypad.show();  
10.       
11.     return app.exec();  
12. }