Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListItem - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Élément de liste de zone de liste déroulante. Lorsque l'objet est sérialisée au format xml, son nom complet est w:listItem.

Espace de noms :  DocumentFormat.OpenXml.Wordprocessing
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class ListItem : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

listItem (élément de zone de liste modifiable)

Cet élément spécifie un élément de liste unique au sein de la balise de document structuré de zone parent liste déroulante. Chaque élément de liste doit être affiché dans la liste affichée pour la balise de document parent structuré (si une interface utilisateur n'est présente).

[Exemple: considérez la balise de document structuré de zone liste déroulante suivante :

<w:sdt>
  <w:sdtPr>
    <w:comboBox>
      <w:listItem w:displayText="Zero" w:value="0"/>
      <w:listItem w:displayText="One" w:value="1"/>
    </w:comboBox>
  </w:sdtPr>
  …</w:sdt>

Chaque élément listItem au sein de l'élément de zone de liste modifiable spécifie une entrée d'élément de liste unique, dans ce cas résultant dans deux éléments de liste au sein de la balise de document structuré de zone parent liste déroulante. fin de l'exemple]

Éléments parents

comboBox (§17.5.2.5)

Attributs

Description

texteaffiché (texte d'affichage entrée de liste)

Spécifie le texte à afficher dans le contenu de l'exécution (ainsi que toute interface utilisateur fourni) à la place le contenu d'attribut de valeur pour cette entrée de liste déroulante.

Cette valeur doit être utilisée comme suit :

  • Si la balise de document structuré de parent est mappée à un élément XML personnalisé, la valeur de cet élément XML personnalisé doit être mis en correspondance le contenu de l'attribut value et la valeur d'attribut texteaffiché qui en résulte (le cas échéant) doit être affichée dans le contenu d'exécution. Si aucun attribut texteaffiché n'est présent, la valeur doit s'afficher.

  • Si l'entrée correspondante est sélectionnée via une interface utilisateur, cette valeur doit être stockée dans le contenu d'exécution de l'élément parent dans le document (il s'agit de la valeur qui est indiquée dans le contenu du document WordprocessingML).

Si cet attribut est omis, le contenu de l'attribut value doit être utilisé en tant que le texte d'affichage pour l'entrée d'élément de liste en cours.

[Exemple: considérez la balise document de liste déroulante structuré à l'adresse suivante :

<w:sdt>
  <w:sdtPr>
    <w:dropDownList>
      <w:listItem w:displayText="The Letter A" w:value="a"/>
      <w:listItem w:displayText="The Letter B" w:value="b"/>
    </w:
dropDownList>
  </w:sdtPr>
  …</w:sdt>

L'attribut texteaffiché pour la première entrée est la lettre A et le second est La lettre B, par conséquent, ces valeurs sont utilisées pour déterminer que le texte à afficher si le parent structurées balise document est mappé sur les données XML personnalisées dans une partie XML personnalisée. fin de l'exemple]

Les valeurs possibles de cet attribut sont définies par le type simple ST_String (§22.9.2.13).

valeur (valeur de l'entrée de liste)

Spécifie la valeur de l'entrée d'élément de liste en cours.

Cette valeur doit être utilisée comme suit :

  • Si le parent structurées balise document sont mappée sur un élément XML personnalisé, la valeur dans la mesure où les éléments XML personnalisés doivent être mappés à cette valeur et la valeur d'attribut texteaffiché qui en résulte (le cas échéant) doit être affichée dans le contenu d'exécution. Si aucun attribut texteaffiché n'est présent, la valeur doit s'afficher.

  • Si l'entrée correspondante est sélectionnée via une interface utilisateur, cette valeur doit être stockée dans la valeur d'attribut de l'élément parent listItem.

[Exemple: considérez la balise de document structuré de zone liste déroulante suivante :

<w:sdt>
  <w:sdtPr>
    <w:comboBox>
      <w:listItem w:displayText="Zero" w:value="0"/>
      <w:listItem w:displayText="One" w:value="1"/>
    </w:comboBox>
  </w:sdtPr>
  …</w:sdt>

L'attribut value pour la première entrée est égale à 0 et le second est 1, par conséquent, ces valeurs sont utilisées pour déterminer que le texte à afficher si le parent structurées balise document est mappé sur les données XML personnalisées dans une partie XML personnalisée. fin de l'exemple]

Les valeurs possibles de cet attribut sont définies par le type simple ST_String (§22.9.2.13).

[Remarque: le W3C XML Schema definition du modèle de contenu de cet élément (CT_SdtListItem) se trouve dans §A.1. note de fin]

[ISO/IEC 29500-1 1st Edition]

listItem (élément de liste déroulante)

Cet élément spécifie un élément de liste unique au sein de la balise de document de liste déroulante structuré parent. Chaque élément de liste doit être affiché dans la liste affichée pour la balise de document parent structuré (si une interface utilisateur n'est présente).

[Exemple: considérez la balise de document structuré de zone liste déroulante suivante :

<w:sdt>
  <w:sdtPr>
    <w:dropDownList>
      <w:listItem w:displayText="The Letter A" w:value="a"/>
      <w:listItem w:displayText="The Letter B" w:value="b"/>
    </w:dropDownList>
  </w:sdtPr>
  …</w:sdt>

Chaque élément listItem au sein de l'élément dropDownList spécifie une entrée d'élément de liste unique, dans ce cas résultant dans deux éléments de liste au sein de la balise de document de liste déroulante structuré parent. fin de l'exemple]

Éléments parents

dropDownList (§17.5.2.15)

Attributs

Description

texteaffiché (texte d'affichage entrée de liste)

Spécifie le texte à afficher dans le contenu de l'exécution (ainsi que toute interface utilisateur fourni) à la place le contenu d'attribut de valeur pour cette entrée de liste déroulante.

Cette valeur doit être utilisée comme suit :

  • Si la balise de document structuré de parent est mappée à un élément XML personnalisé, la valeur de cet élément XML personnalisé doit être mis en correspondance le contenu de l'attribut value et la valeur d'attribut texteaffiché qui en résulte (le cas échéant) doit être affichée dans le contenu d'exécution. Si aucun attribut texteaffiché n'est présent, la valeur doit s'afficher.

  • Si l'entrée correspondante est sélectionnée via une interface utilisateur, cette valeur doit être stockée dans le contenu d'exécution de l'élément parent dans le document (il s'agit de la valeur qui est indiquée dans le contenu du document WordprocessingML).

Si cet attribut est omis, le contenu de l'attribut value doit être utilisé en tant que le texte d'affichage pour l'entrée d'élément de liste en cours.

[Exemple: considérez la balise document de liste déroulante structuré à l'adresse suivante :

<w:sdt>
  <w:sdtPr>
    <w:dropDownList>
      <w:listItem w:displayText="The Letter A" w:value="a"/>
      <w:listItem w:displayText="The Letter B" w:value="b"/>
    </w:
dropDownList>
  </w:sdtPr>
  …</w:sdt>

L'attribut texteaffiché pour la première entrée est la lettre A et le second est La lettre B, par conséquent, ces valeurs sont utilisées pour déterminer que le texte à afficher si le parent structurées balise document est mappé sur les données XML personnalisées dans une partie XML personnalisée. fin de l'exemple]

Les valeurs possibles de cet attribut sont définies par le type simple ST_String (§22.9.2.13).

valeur (valeur de l'entrée de liste)

Spécifie la valeur de l'entrée d'élément de liste en cours.

Cette valeur doit être utilisée comme suit :

  • Si le parent structurées balise document sont mappée sur un élément XML personnalisé, la valeur dans la mesure où les éléments XML personnalisés doivent être mappés à cette valeur et la valeur d'attribut texteaffiché qui en résulte (le cas échéant) doit être affichée dans le contenu d'exécution. Si aucun attribut texteaffiché n'est présent, la valeur doit s'afficher.

  • Si l'entrée correspondante est sélectionnée via une interface utilisateur, cette valeur doit être stockée dans la valeur d'attribut de l'élément parent listItem.

[Exemple: considérez la balise de document structuré de zone liste déroulante suivante :

<w:sdt>
  <w:sdtPr>
    <w:comboBox>
      <w:listItem w:displayText="Zero" w:value="0"/>
      <w:listItem w:displayText="One" w:value="1"/>
    </w:comboBox>
  </w:sdtPr>
  …</w:sdt>

L'attribut value pour la première entrée est égale à 0 et le second est 1, par conséquent, ces valeurs sont utilisées pour déterminer que le texte à afficher si le parent structurées balise document est mappé sur les données XML personnalisées dans une partie XML personnalisée. fin de l'exemple]

Les valeurs possibles de cet attribut sont définies par le type simple ST_String (§22.9.2.13).

[Remarque: le W3C XML Schema definition du modèle de contenu de cet élément (CT_SdtListItem) se trouve dans §A.1. note de fin]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: