InsertXMLList

InsertXMLList()

Syntaxe

Resultat = InsertXMLList(NoeudParent, Liste() [, NoeudPrecedent])

Description

Insère une liste dans un noeud.

Arguments

NoeudParent Le noeud dans lequel insérer le nouveau noeud.

Pour insérer le nouveau noeud à la racine de l'arbre, utiliser RootXMLNode().

Liste() La liste à insérer.

NoeudPrecedent (optionnel) Un noeud enfant du noeud parent après qui le nouveau noeud doit être inséré.
Si cette valeur est 0 ou non spécifiée, le nouveau noeud est inséré comme premier enfant de son parent.
Si cette valeur est -1, le noeud est inséré comme dernier enfant de son parent.

Valeur de retour

Le nouveau noeud XML s'il a été créé avec succès, zéro sinon.

Remarques

Les règles spécifiées dans CreateXMLNode() pour le cas où un nouveau noeud est inséré s'appliquent également à cette fonction.

Le noeud inséré est nommé "list" et les éléments de la liste sont insérés sous le nom "element". Voir ci-dessous un exemple.

Exemple

  ; Cet exemple produit l'arbre XML suivant:
  ;
  ; <list>
  ;   <element>carré</element>
  ;   <element>cercle</element>
  ;   <element>triangle</element>
  ; </list>
  ;
  NewList Formes$()
  AddElement(Formes$()): Formes$() = "carré"
  AddElement(Formes$()): Formes$() = "cercle"
  AddElement(Formes$()): Formes$() = "triangle"

  If CreateXML(0)
    InsertXMLList(RootXMLNode(0), Formes$())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
  EndIf

Exemple

  ; Cet exemple produit l'arbre XML suivant:
  ;
  ; <list>
  ;   <element>
  ;     <x>100</x>
  ;     <y>200</y>
  ;   </element>
  ;   <element>
  ;     <x>200</x>
  ;     <y>400</y>
  ;   </element>
  ; </list>
  ;
  Structure Position
    x.l
    y.l
  EndStructure
  
  NewList Positions.Position()
  
  For i = 1 To 2
    AddElement(Positions())
    Positions()\x = 100 * i
    Positions()\y = 200 * i
  Next i

  If CreateXML(0)
    InsertXMLList(RootXMLNode(0), Positions())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
  EndIf

Voir aussi

ExtractXMLList(), InsertXMLArray(), InsertXMLMap(), InsertXMLStructure()

OS Supportés

Tous

<- InsertXMLArray() - XML Index - InsertXMLMap() ->

NoeudParent	Le noeud dans lequel insérer le nouveau noeud. Pour insérer le nouveau noeud à la racine de l'arbre, utiliser RootXMLNode().
Liste()	La liste à insérer.
NoeudPrecedent (optionnel)	Un noeud enfant du noeud parent après qui le nouveau noeud doit être inséré. Si cette valeur est 0 ou non spécifiée, le nouveau noeud est inséré comme premier enfant de son parent. Si cette valeur est -1, le noeud est inséré comme dernier enfant de son parent.