Qt小部件的命名約定

Question

我正與一羣其他程序員合作開發使用C++和Qt構建的開源項目。

現在，我們需要一個小部件（以及其他變量）的命名約定，將其用作所有代碼中的標準，以便代碼具有更好的可讀性，並且我們可以更好地協調程序員。

有什麼建議嗎？

編輯：我不是在談論命名新的類，

，而不是我說的命名Qt控件的情況下，讓我們說我有一個用戶名文本編輯，我應該命名爲txtEdtUsrNm？

在這種情況下，我該如何選擇派生？

Answer 1

只要你正在思考這些問題，我首先會從頭到尾閱讀這篇QtQuarterly文章。

Designing Qt-Style C++ APIs

這就是說，一件事，我們要做的就是把該實例的「使用」的第一部分和類作爲最後部分的最後一個完整的單詞。

所以，你的 「用戶名」 的QTextEdit是

QTextEdit * userNameEdit = new QTextEdit(this); 

如果有歧義，如而QListView和QTreeView則，挑選最後unabiguous部分。

QListView * userListView; 

你可以找出縮寫你怎麼樣（如「的Lbl」爲QLabel），但通常，整個單詞已經工作，並一直易於閱讀。

另一方面，我們對此並不太嚴格，可能更重要的是在沒有類名的情況下命名實例變量的意圖，因爲如果將來想要更改類，則會得到改變這個名字，如果沒有好的重構工具，這是一種痛苦。

也許找出你最常用的小部件，然後爲最一般的超類選擇一個命名約定，讓所有其他部分都去。的事情，堅持公約

列表示例：

• 佈局=爲此在 「佈局」，並繼承QLayout所有類
• 按鈕=該結束「按鈕」，並且繼承QAbstractButton所有課程

的QAbstract 類名類想想應該是在該名單有什麼好地方。

Answer 2

我只會使用與Qt使用相同的命名約定。讓自己輕鬆一下。

它們的命名約定與java類似。

Answer 3

的全名迅速成爲麻煩閱讀和類型，所以我們通常使用的縮寫：

QLabel * fooLB; 
QPushButton * fooPB; 
QTextEdit * fooTE; 
QSpinBox * fooSB; 

（你得到的漂移）。是的，有些含糊不清，但通常是從上下文中解決。

Answer 4

由於Qt向第三方開發者開放，他們提供了一些關於編碼風格和API設計原則的文檔。

這些文件真的很有趣。這裏有幾個環節：

Wiki : Qt Coding Style

Wiki : Api Design Principles

而這個文件從茉莉布蘭切特，這是值得一讀（PDF）：Little Manual of API Design

Answer 5

準確地說，問題是關於「命名Qt Widgets的實例「，但答案是關於命名變量的變量，它們持有對小部件實例的引用。

Qt Widgets派生自QObject，它具有getter objectName（）的name屬性。如果程序員不這樣做，Qt會給這個屬性一個值嗎？將其稱爲「自動生成」或「默認」值。