Condividi tramite


<list>tag di documentazione e <listheader>

Il <listheader> blocco viene usato per definire la riga di intestazione di una tabella o di un elenco di definizioni. Per definire una tabella, è sufficiente specificare una voce per il termine nell'intestazione.

Sintassi

<list type="bullet" | "number" | "table">
   <listheader>
      <term>term</term>
      <description>description</description>
   </listheader>
   <item>
      <term>term</term>
      <description>description</description>
   </item>
</list>

Parametri

term
Termine da definire, che verrà definito in description.

description
Elemento di un elenco puntato o numerato oppure la definizione di un term.

Osservazioni:

Ogni elemento dell'elenco viene specificato con un <item> blocco. Quando si crea un elenco di definizioni, è necessario specificare sia term che description. Per le tabelle e gli elenchi puntati o numerati, tuttavia, è sufficiente fornire una voce per description.

Un elenco o una tabella può avere il numero di <item> blocchi necessario.

Compilare con /doc per elaborare i commenti della documentazione in un file.

Esempio

// xml_list_tag.cpp
// compile with: /doc /LD
// post-build command: xdcmake xml_list_tag.dll
/// <remarks>Here is an example of a bulleted list:
/// <list type="bullet">
/// <item>
/// <description>Item 1.</description>
/// </item>
/// <item>
/// <description>Item 2.</description>
/// </item>
/// </list>
/// </remarks>
class MyClass {};

Vedi anche

Documentazione XML