2013-07-30 26 views
13

Qt Creator kullanıyordum ve ben bu yüzden yazmıştı benim işlev tanımı yukarıda benim imleci konumlandırılmış ve şöyle /**<ENTER> yazılan bir işlevi belgelemek istedik karar:Kendi işlevimin otomatik belgelerini Qt Creator ile mi kullanıyorsunuz?

/**<ENTER> 
void MyClass::myFunction(int myArg) 
{ 
... 

Qt Creator otomatik olarak genişletilen bu yorum:

/** 
* @brief MyClass::myFunction 
* @param myArg 
*/ 
void MyClass::myFunction(int myArg) 
{ 
... 

Bu nedir? Nerede belgeleniyor?

Kendi Qt Assistant qch yardım dosyalarımı oluşturmak için bunu kullanabilir miyim?

cevap

24

O here belgelenmiş ya here, ama onun değil ...

Yani burada bu konuda bazı bilgiler verilmiştir edilmelidir:

bu özelliğin ayarlarını burada bulunur:

Pencereler:

Qt Oluşturucu> Araçlar> Seçenekler> Metin Düzenleyici> Tamamlama> Belgeler Yorumlar

Mac OS X:

Qt Creator> Tercihler> Metin Düzenleyici> Tamamlama> Belgeler listelediği olan

üç seçenek Yorumlar:

  • Doxygen blokları etkinleştirme
  • kısa bir açıklama üret
  • Ana borularını ekleyiniz

(Qt 2.6 Bulundu ancak muhtemelen önceki sürümlerinde de ?, yoksa bir noktada ayarlanan varsayılan eklenti parçası olabilir.)

oluşturulan taslakları Doxygen stil koçanları vardır.

Doxygen'i kaynak kodunuzda yayınlamak ve hem chm dosyasında hem de html belgesinde ve pdf'de bazı süslü belgeler oluşturmak için kullanabilirsiniz.

http://www.stack.nl/~dimitri/doxygen/

http://www.stack.nl/~dimitri/doxygen/manual/output.html (qCH dosyaları içerir) İşte

ilgili Qt Creator için eklentidir:

http://dev.kofee.org/projects/qtcreator-doxygen/wiki

Ve kendi programında QHelpEngine kullanarak ...

http://qt-project.org/doc/qt-4.8/qthelp-framework.html

Ve son olarak, bir yardım tarz url işlemek için QDesktopServices kullanabilirsiniz: yardımcı

http://doc-snapshot.qt-project.org/4.8/qdesktopservices.html#url-handlers

Umut.

+2

Biliyorsunuz, Qt dokümantasyon genellikle şaşırtıcı, ama bu gibi kenar vakaları var (ve benim için stil sayfaları kullanarak), bir özellik için doğru belgelerin nasıl bulunacağına dair hiçbir fikrim yok. Bu kadar detaylı bilgi için teşekkürler. –

+0

Sorun değil. QStyleSheets şeyler bazı deneme ve hata gerektiriyor, ancak CSS davranışından çok farklı değil. QStyleSheets ile bir çok şey karıştırıyorsanız, değişiklik ve farklı bir tane yüklemek istiyorum. İşte stil sayfaları ile yaptığım en gelişmiş şey: http://stackoverflow.com/questions/13564823/qlist-out-of-memory/13568733#13568733 İyi şanslar. – phyatt

+0

'Doxygen block'ları etkinleştirin, ne yaptığından emin değil misiniz? Doxygen etiketlerini otomatik tamamlamalı mı? Bana hiçbir şey göstermiyor - otomatik tamamlama yok. Herhangi bir fikir? –

İlgili konular