MoveElement()

Syntax

MoveElement(Liste(), Lokation [, *RelativesElement])
Beschreibung
Verschiebt das aktuelle Element der angegebenen Liste an eine andere Position in der Liste. Das verschobene Element bleibt das aktuelle Element in der Liste. Dies ist eine schnelle Operation, da die Element-Daten selbst nicht verschoben werden, um die Position in der Liste zu ändern.

Parameter

Liste() Der Variablenname der verknüpften Liste, welche mit dem NewList Befehl erstellt wurde. Sie müssen die Klammern nach dem Listennamen immer angeben.
Lokation Position, wohin das aktuelle Element verschoben werden soll. Dies kann einer der folgenden Werte sein: 
  #PB_List_First : Verschiebe das Element an den Anfang der Liste
  #PB_List_Last  : Verschiebe das Element an das Ende der Liste
  #PB_List_Before: Verschiebe das Element vor das *RelativesElement
  #PB_List_After : Verschiebe das Element nach das *RelativesElement
*RelativesElement (optional) Die Adresse eines anderen Elements, wohin das aktuelle Element verschoben werden soll. Dieser Parameter wird benötigt, wenn der Parameter 'Lokation' #PB_List_Before oder #PB_List_After lautet. Sie können diese Adresse durch Verwendung des @ Operators auf den Listennamen erhalten.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

  NewList Numbers()
  
  For k=0 To 10
    AddElement(Numbers())
    Numbers() = k
  Next
  
  SelectElement(Numbers(), 5) 
  *Relative = @Numbers()                             ; ermittle die Adresse von Element 5
  
  SelectElement(Numbers(), 0)
  MoveElement(Numbers(), #PB_List_After, *Relative)  ; verschiebe an die Stelle nach dem ELement 5
    
  SelectElement(Numbers(), 10)
  MoveElement(Numbers(), #PB_List_First)             ; verschiebe an den Anfang
    
  ; Ergebnis
  ;
  ForEach Numbers()
    Debug Numbers()
  Next

Siehe auch

SwapElements()

Unterstützte OS

Alle

<- MergeLists() - List Inhaltsverzeichnis - NextElement() ->