Archive:Development/Tutorials/Qt4 Ruby Tutorial/Chapter 14 (zh TW)
Template:I18n/Language Navigation Bar (zh TW) Template:TutorialBrowser (zh TW)
Facing the Wall
檔案：
概覽
這是最後的範例：一個完整的遊戲。
我們加上鍵盤快捷鍵（accelerator）和引入滑鼠事件到 CannonField。我們放置了一個環繞 CannonField 的外框，並加上一個障礙（牆），使遊戲更具挑戰性。
一行一行的瀏覽
CannonField 現在可以接收滑鼠事件，讓使用者透過按下並拖動砲管來瞄準。CannonField 也有障礙牆了。
@barrelPressed = false
這行加入到建構子。最初，滑鼠沒有在砲管上按下。
elsif shotR.x() > width() || shotR.y() > height() ||
shotR.intersects(barrierRect())
現在，我們有一個障礙，也就是第三種不擊中的方法。我們也測試第三種。（在 moveShot()。）
def mousePressEvent(event)
unless event.button() == Qt::LeftButton
return
end
if barrelHit(event.pos())
@barrelPressed = true
end
end
這是一個 Qt 事件處理器。當游標在 widget 上，且使用者按下滑鼠按鈕時，它會被呼叫。
如果事件不是滑鼠左鍵產生的，我們立即返回。否則，我們檢查游標的位置是否在加農砲的砲管內。假如是，我們就設定 barrelPressed 為 true。
請注意，Qt::MouseEvent::pos() 函式會返回一個 Widget 坐標系統中的點。
def mouseMoveEvent(event)
unless @barrelPressed
return
end
pos = event.pos();
if pos.x() <= 0
pos.setX(1)
end
if pos.y() >= height()
pos.setY(height() - 1)
end
rad = atan2((rect().bottom() - pos.y()), pos.x())
setAngle((rad * 180 / 3.14159265).round())
end
這是另一個 Qt 事件處理器。當使用者已經在這個 widget 內按下滑鼠按鈕，然後移動/拖動滑鼠時被呼叫。（即使沒有任何按鍵被按下，您也可以讓 Qt 發送滑鼠移動事件。參閱 Qt::Widget::setMouseTracking()。）
這個處理器會根據游標的位置，重新定位砲管。
首先，如果砲管沒有被按下，我們返回。下一步，我們取得游標的位置。如果游標移到 widget 的左邊或底部，我們調整這個點到 widget 的內部。
然後，我們計算 widget 底邊，與 widget 左下角和游標位置構成假想線之間的角度。最後，我們設定加農砲的角度為換算成度的新值。
記得用 setAngle() 重繪加農砲。
def mouseReleaseEvent(event)
if event.button() == Qt::LeftButton
@barrelPressed = false
end
end
無論使用者何時釋放滑鼠按鈕，且它是在這個 widget 裡面按下時，這個 Qt 事件處理器被呼叫。
如果左邊的按鈕被釋放，我們可以確定砲管已不再被按住了。
繪圖事件還多了一行：
paintBarrier(painter)
paintBarrier() 與 paintShot()、paintTarget()，和 paintCannon() 作同類的事情。
def paintBarrier( painter )
painter.setBrush(Qt::Brush.new(Qt::yellow))
painter.setPen(Qt::Color.new(Qt::black))
painter.drawRect(barrierRect())
end
這個函式繪製一個填充黃色和黑色外框的矩形作為障礙。
def barrierRect()
return Qt::Rect.new(145, height() - 100, 15, 99)
end
這個函式返回障礙的矩形。我們把障礙的底邊固定在 widget 的底邊。
def barrelHit(pos)
matrix = Qt::Matrix.new()
matrix.translate(0, height())
matrix.rotate(-@currentAngle)
matrix = matrix.inverted()
return @barrelRect.contains(matrix.map(pos))
end
如果點在砲管裡，這個函式返回 true；否則返回 false。
這裡我們使用 Qt::Matrix 類別。Qt::Matrix 定義了一個坐標系統映射。它可以執行與 Qt::Painter 相同的轉換。
這裡，我們執行與 paintCannon() 函式中繪製砲管的同樣轉換步驟。首先，我們轉移坐標系，然後旋轉。
現在我們需要檢查點 pos（在 widget 坐標）是否位於砲管內。為了做到這一點，我們倒轉這個轉移矩陣。倒轉矩陣執行了我們使用在繪製砲管的倒轉轉移。我們使用倒轉矩陣來映射點 pos。如果它在原來砲管的矩形裡面，返回 true。
cannonBox = Qt::Frame.new()
cannonBox.setFrameStyle(Qt::Frame::WinPanel | Qt::Frame::Sunken)
我們建立及設定了一個 Qt::Frame，並設定框架的風格。這樣的結果是一個圍繞 CannonField 的3D框架。
Qt::Shortcut.new(Qt::KeySequence.new(Qt::Key_Enter.to_i),
self, SLOT('fire()'))
Qt::Shortcut.new(Qt::KeySequence.new(Qt::Key_Return.to_i),
self, SLOT('fire()'))
Qt::Shortcut.new(Qt::KeySequence.new(Qt::CTRL.to_i + Qt::Key_Q.to_i),
self, SLOT('close()'))
這裡，我們建立並設定三個 Qt::Shortcut 物件。這些物件會擷取（intercept）鍵盤事件到 widget，並在某些鍵被按下時呼叫槽。請注意，Qt::Shortcut 物件是 widget 的子 widget。且在 widget 毀滅時，也會被毀滅。Qt::Shortcut 本身不是一個 widget，在 widget 中也沒有可見的影響。
我們定義了三個快捷鍵。我們希望當使用者按下 Enter 或 Return 時，呼叫 fire() 槽。我們也希望當按下 Ctrl+Q 鍵時，應用程式退出。這次我們連接到 Qt::Widget::close()，而不是 Qt::CoreApplication::quit()。由於 GameBoard 是應用程式主要的 widget，這樣做與 QCoreApplication::quit() 有同樣的效果。
Qt::CTRL、Qt::Key_Enter、Qt::Key_Return，和 Qt::Key_Q 都是宣告在 Qt 名稱空間裡的常數。不幸的是，在 qtruby 的當前版本，他們需要轉換為整數，才能使用它們在我們的快捷鍵。
leftLayout = Qt::VBoxLayout.new()
leftLayout.addWidget(angle)
leftLayout.addWidget(force)
gridLayout = Qt::GridLayout.new()
gridLayout.addWidget(quit, 0, 0)
gridLayout.addLayout(topLayout, 0, 1)
gridLayout.addLayout(leftLayout, 1, 0)
gridLayout.addWidget(@cannonField, 1, 1, 2, 1)
gridLayout.setColumnStretch(1, 10)
setLayout(gridLayout)
我們給 cannonBox 它自己的 Qt::VBoxLayout，並且加入 CannonField 到佈局中。這間接使得 CannonField 成為 cannonBox 的一個子 widget。因為沒有其它東西在這個盒子裡，結果就是 Qt::VBoxLayout 會放置一個環繞著 CannonField 的框架。我們放置 cannonBox，而不是 CannonField，到網格佈局中。
執行應用程式
現在加農砲會在您按下 Enter 時射擊。您還可以使用滑鼠定位加農砲的角度。障礙使得遊戲變得更具挑戰性。We also have a nice looking frame around the CannonField .我們也有一個好看的外框圍繞CannonField。
練習
寫一個太空入侵者遊戲。
（這項練習是由 Igor Rafienko 首先做出。您可以下載他的遊戲。）
新的練習是：寫一個打磚塊遊戲。
最後的忠告：繼續往前走，並創造程式設計藝術的傑作！