Qt 5.11 - Tables and Lists

टेबल्स और सूची




qt

टेबल्स और सूची

ये कमांड लिस्ट और टेबल बनाने में सक्षम हैं। एक सूची प्रदान की गई है जिसे एक अलग अनुच्छेद के रूप में संरेखित किया गया है। एक तालिका को एक अलग अनुच्छेद के रूप में केंद्रित किया गया है। तालिका की चौड़ाई इसकी सामग्री की चौड़ाई पर निर्भर करती है।

\ तालिका

\ Table और \ endtable आदेश एक तालिका की सामग्री का परिसीमन करते हैं।

आदेश पृष्ठ की चौड़ाई के प्रतिशत के रूप में तालिका की चौड़ाई को निर्दिष्ट करने वाले एकल तर्क को स्वीकार करता है:

/ *!
    \table 100 %

       ...

    \endtable
* /

उपरोक्त कोड यह सुनिश्चित करता है कि तालिका सभी उपलब्ध स्थान को भरेगी। यदि तालिका की चौड़ाई 100% से कम है, तो तालिका जनरेट किए गए दस्तावेज़ में केंद्रित होगी।

एक तालिका में हेडर, रो और कॉलम हो सकते हैं। एक पंक्ति एक \row कमांड के साथ शुरू होती है और इसमें सेल होते हैं, जिनमें से प्रत्येक एक \li कमांड से शुरू होता है। एक \header कमांड भी है जो एक विशेष प्रकार की पंक्ति है जिसका एक विशेष प्रारूप है।

/ *!
    \table
    \header
        \li Qt Core Feature
        \li Brief Description
    \row
        \li \l {Signal and Slots}
        \li Signals and slots are used for communication
           between objects.
    \row
        \li \l {Layout Management}
        \li The Qt layout system provides a simple
           and powerful way of specifying the layout
           of child widgets.
    \row
        \li \l {Drag and Drop}
        \li Drag and drop provides a simple visual
           mechanism which users can use to transfer
           information between and within applications.
    \endtable
* /

QDoc इसे प्रस्तुत करता है:

क्यूटी कोर फ़ीचर संक्षिप्त विवरण
सिग्नल और स्लॉट सिग्नल और स्लॉट वस्तुओं के बीच संचार के लिए उपयोग किए जाते हैं।
लेआउट प्रबंधन Qt लेआउट सिस्टम बाल विगेट्स के लेआउट को निर्दिष्ट करने का एक सरल और शक्तिशाली तरीका प्रदान करता है।
खींचें और छोड़ें ड्रैग एंड ड्रॉप एक सरल दृश्य तंत्र प्रदान करता है जिसका उपयोग उपयोगकर्ता अनुप्रयोगों के बीच और भीतर जानकारी स्थानांतरित करने के लिए कर सकते हैं।

आप सेल को कई पंक्तियों और स्तंभों में भी बना सकते हैं। उदाहरण के लिए:

/ *!
    \table
    \header
        \li {3,1} This header cell spans three columns,
           but only one row.
    \row
        \li {2, 1} This table cell spans two columns,
           but only one row
        \li {1, 2} This table cell spans only one column,
        but two rows.
    \row
        \li A regular table cell
        \li A regular table cell
    \endtable
* /

QDoc इसे प्रस्तुत करता है:

यह हेडर सेल तीन कॉलम फैलाता है, लेकिन केवल एक पंक्ति।
यह तालिका कक्ष दो स्तंभों तक फैला है, लेकिन केवल एक पंक्ति है। यह टेबल सेल केवल एक कॉलम, लेकिन दो पंक्तियों तक फैला है।
एक नियमित टेबल सेल एक नियमित टेबल सेल

\header , \row और \li भी देखें।

\ हैडर कमांड इंगित करता है कि निम्न तालिका कोशिकाएं वर्तमान तालिका के कॉलम हेडर हैं।

कमांड का उपयोग केवल \table...\endtable कमांड के भीतर किया जा सकता है। एक हेडर में कई सेल हो सकते हैं। एक सेल \li कमांड के साथ बनाया गया है।

एक हेडर सेल का टेक्स्ट टेबल सेल के भीतर केंद्रित होता है और एक बोल्ड फ़ॉन्ट का उपयोग करके प्रदान किया जाता है।

/ *!
    \table
    \header
        \li Qt Core Feature
        \li Brief Description
    \row
        \li \l {Signal and Slots}
        \li Signals and slots are used for communication
           between objects.
    \endtable
* /

QDoc इसे प्रस्तुत करता है:

क्यूटी कोर फ़ीचर संक्षिप्त विवरण
सिग्नल और स्लॉट सिग्नल और स्लॉट वस्तुओं के बीच संचार के लिए उपयोग किए जाते हैं।

\table...\endtable , \row और \li भी देखें।

\ पंक्ति

\ पंक्ति कमांड एक तालिका में एक नई पंक्ति शुरू करता है। नई पंक्ति में मौजूद \li तुरंत \ पंक्ति का अनुसरण करेंगे।

कमांड का उपयोग केवल \table...\endtable कमांड के भीतर किया जा सकता है। एक पंक्ति में कई सेल हो सकते हैं। एक सेल \li कमांड के साथ बनाया गया है।

प्रत्येक पंक्ति की पृष्ठभूमि सेल का रंग दो रंगों के ग्रे के बीच वैकल्पिक होता है, जिससे पंक्तियों को एक दूसरे से अलग करना आसान हो जाता है। कोशिकाओं की सामग्री संरेखित की जाती है।

/ *!
    \table
    \header
        \li Qt Core Feature
        \li Brief Description
    \row
        \li \l {Signal and Slots}
        \li Signals and slots are used for communication
           between objects.
    \row
        \li \l {Layout Management}
        \li The Qt layout system provides a simple
           and powerful way of specifying the layout
           of child widgets.
    \row
        \li \l {Drag and Drop}
        \li Drag and drop provides a simple visual
           mechanism which users can use to transfer
           information between and within applications.
    \endtable
* /

QDoc इसे प्रस्तुत करता है:

क्यूटी कोर फ़ीचर संक्षिप्त विवरण
सिग्नल और स्लॉट सिग्नल और स्लॉट वस्तुओं के बीच संचार के लिए उपयोग किए जाते हैं।
लेआउट प्रबंधन Qt लेआउट सिस्टम बाल विगेट्स के लेआउट को निर्दिष्ट करने का एक सरल और शक्तिशाली तरीका प्रदान करता है।
खींचें और छोड़ें ड्रैग एंड ड्रॉप एक सरल दृश्य तंत्र प्रदान करता है जिसका उपयोग उपयोगकर्ता अनुप्रयोगों के बीच और भीतर जानकारी स्थानांतरित करने के लिए कर सकते हैं।

\table...\endtable , \header और \li भी देखें।

\ मूल्य

\ Value कमांड C ++ एनम आइटम का प्रलेखन शुरू करता है।

कमांड का पहला तर्क मूल्य नाम है। वर्ग कोष्ठक में दिए गए खंड के बाद से मूल्य नाम एक वैकल्पिक से पहले हो सकता है। मान विवरण मान नाम का अनुसरण करता है। वर्णन अगली रिक्त पंक्ति या \ मान पर समाप्त होता है। तर्कों को एक तालिका में प्रस्तुत किया गया है।

क्लॉज के बिना, एक \ value कमांड इस तरह दिख सकता है:

\value QtInfoMsg A message generated by the qInfo() function.

क्लॉज के बाद से एक ही कमांड इस तरह दिखेगा:

\value [since 5.5] QtInfoMsg A message generated by the qInfo() function.

प्रलेखन संबंधित वर्ग, हेडर फ़ाइल या नामस्थान प्रलेखन में स्थित होगा। एक उदाहरण के लिए \enum प्रलेखन देखें।

नोट: क्यूटी 5.4 के बाद, \enum विषय के बाहर \ value कमांड का उपयोग भी किया जा सकता है। इस मामले में, QDoc निरंतर नाम (जैसा कि पहले तर्क से लिया गया है) और इसके विवरण को सूचीबद्ध करते हुए एक दो-स्तंभ तालिका प्रस्तुत करता है। इसका उपयोग किया जा सकता है, उदाहरण के लिए, QML एन्यूमरेशन प्रॉपर्टी के लिए स्वीकार्य मानों के दस्तावेजीकरण के लिए \qmlproperty विषय में।

\enum और \omitvalue भी देखें।

\ omitvalue

\ Omitvalue कमांड प्रलेखन से C ++ एन्यूम आइटम को बाहर करता है।

कमांड का एकमात्र तर्क एनम आइटम का नाम है जिसे छोड़ दिया जाएगा। एक उदाहरण के लिए \enum प्रलेखन देखें।

तब से \enum और \value \since देखें

\सूची

\ List और \ endlist आदेश आइटम की एक सूची का परिसीमन करते हैं।

प्रत्येक सूची आइटम को \li कमांड के साथ बनाएं। एक सूची में हमेशा एक या अधिक आइटम होते हैं। सूची को नेस्टेड किया जा सकता है। उदाहरण के लिए:

/ *!
    \list
    \li Qt Reference Documentation: Getting Started
        \list
        \li How to Learn Qt
        \li Installation
            \list
            \li Qt/X11
            \li Qt/Windows
            \li Qt/Mac
            \li Qt/Embedded
            \endlist
        \li Tutorial and Examples
        \endlist
    \endlist
* /

QDoc इसे प्रस्तुत करता है:

  • Qt संदर्भ दस्तावेज: आरंभ करना
    • कैसे जानें क्यूटी
    • स्थापना
      • क्यूटी / X11
      • क्यूटी / विंडोज
      • क्यूटी / मैक
      • क्यूटी / एंबेडेड
    • ट्यूटोरियल और उदाहरण

सूची आइटम के लिए वैकल्पिक सूची प्रदान करने वाला एक वैकल्पिक तर्क \ सूची कमांड लेता है।

/ *!
    \list
        \li How to Learn Qt
        \li Installation
        \li Tutorial and Examples
    \endlist
* /

QDoc बुलेट (डिफ़ॉल्ट) के साथ सूची आइटम प्रस्तुत करता है:

  • कैसे जानें क्यूटी
  • स्थापना
  • ट्यूटोरियल और उदाहरण

चेतावनी: यहाँ qdoc में एक बग प्रतीत होता है। यदि आप किसी प्रकार के तर्क को शामिल करते हैं, तो आपको एक संख्यात्मक सूची मिलती है। हम इसे देख रहे हैं।

यदि आप 'A' को \ List कमांड के तर्क के रूप में प्रदान करते हैं, तो गोलियों को वर्णानुक्रम में वर्णों से बदल दिया जाता है:

  1. कैसे जानें क्यूटी
  2. स्थापना
  3. ट्यूटोरियल और उदाहरण

यदि आप 'A' को '1' से बदलते हैं, तो सूची आइटम को आरोही क्रम में क्रमांकित किया जाता है:

  1. कैसे जानें क्यूटी
  2. स्थापना
  3. ट्यूटोरियल और उदाहरण

यदि आप तर्क के रूप में 'i' प्रदान करते हैं, तो गोलियों को रोमन अंकों के साथ बदल दिया जाता है:

  1. कैसे जानें क्यूटी
  2. स्थापना
  3. ट्यूटोरियल और उदाहरण

अंत में, यदि आप वैकल्पिक तर्क के रूप में 'I' प्रदान करते हैं, तो आप सूची आइटम को आरोही क्रम में निम्नलिखित रोमन नंबरों के साथ प्रदर्शित कर सकते हैं:

  1. कैसे जानें क्यूटी
  2. स्थापना
  3. ट्यूटोरियल और उदाहरण

आप किसी भी वर्ण या संख्या पर लिस्टिंग प्रारंभ कर सकते हैं बस उस संख्या या चरित्र को प्रदान करें जिसे आप शुरू करना चाहते हैं। उदाहरण के लिए:

/ *!
    \list G
        \li How to Learn Qt
        \li Installation
        \li Tutorial and Examples
    \endlist
* /

नोट: यह DITA XML में काम नहीं करता है, इसलिए इसका उपयोग न करें क्योंकि यह एक DITA XML फ़ाइल बनाता है जो मान्य नहीं करता है। डीआईटीए में ऐसा करने का एक तरीका है, इसलिए यदि हम इसका पता लगाते हैं, तो हम इसे डाल देंगे। लेकिन इस क्षमता का उपयोग यहीं नहीं किया जाता है, इसलिए यह महत्वपूर्ण नहीं है। अभी के लिए, यदि आप इस विकल्प का उपयोग करते हैं, तो qdoc इसे अनदेखा करेगा और इसके बिना एक सूची तैयार करेगा।

QDoc इसे प्रस्तुत करता है:

  1. कैसे जानें क्यूटी
  2. स्थापना
  3. ट्यूटोरियल और उदाहरण

यह भी देखें \li

\ ली (तालिका सेल, सूची आइटम)

\ Li आदेश तालिका तालिका या सूची आइटम को चिह्नित करता है। यह आदेश केवल \table...\endtable और lists में उपयोग किया जाता है।

यह अगले \ li कमांड, अगले \table...\endtable , या lists कमांड तक सब कुछ अपने तर्क के रूप में मानता है। उदाहरणों के लिए \table...\endtable और lists देखें।

यदि आदेश एक तालिका के भीतर उपयोग किया जाता है, तो आप यह भी निर्दिष्ट कर सकते हैं कि आइटम को कितनी पंक्तियाँ या स्तंभ चाहिए।

/ *!
    \table
    \header
        \li {3,1} This header cell spans three columns
           but only one row.
    \row
        \li {2, 1} This table item spans two columns
           but only one row
        \li {1, 2} This table item spans only one column,
        but two rows.
    \row
        \li A regular table item
        \li A regular table item
    \endtable
* /

QDoc इसे प्रस्तुत करता है:

यह हेडर सेल तीन कॉलम फैलाता है, लेकिन केवल एक पंक्ति।
यह तालिका आइटम दो स्तंभों तक फैला है, लेकिन केवल एक पंक्ति है। यह टेबल आइटम केवल एक कॉलम, लेकिन दो पंक्तियों तक फैला है।
एक नियमित टेबल आइटम एक नियमित टेबल आइटम

यदि निर्दिष्ट नहीं है, तो आइटम एक कॉलम और एक पंक्ति को फैलाएगा।

\table...\endtable , \header और lists भी देखें।