pos = moai.DoMethod(id, "Insert", pos, [icon1,] column1$, ...)

Die Eingabedaten bestehen aus einer Textzeichenkette und, wenn die Spalte das Attribut Listviewcolumn.Icon hat, einem Symbol für jede Spalte. Das Symbol muss vor der Textzeichenkette übergeben werden und es muss ein Identifikator eines Hollywood-Pinsels/-Icon sein, der als Symbol für den Eintrag verwendet werden soll. Wenn Listviewcolumn.Icon nicht gesetzt ist, müssen Sie den Parameter Icon weglassen und nur Textdaten für den Listenansichts-Eintrag übergeben. Wenn Sie Listviewcolumn.Icon auf True gesetzt haben und kein Symbol in dieser bestimmten Zeile und Spalte anzeigen möchten, können Sie auch den speziellen Wert -1 übergeben. In diesem Fall zeigt RapaGUI kein Symbol an, obwohl Listviewcolumn.Icon auf True gesetzt wurde. Bitte beachten Sie, dass automatisch generierte IDs nicht verwendet werden können. Bitte lesen Sie auch den Bilder-Cache von RapaGUI, um mehr über die Unterstützung von Symbolen in RapaGUI zu erfahren. Siehe Bilder-Cache für Details.

Falls eine Spalte ein Auswahlkästchen (Checkbox) zeigt, müssen Sie "On", "True" oder "1" übergeben, um das Auswahlkästchen und einen beliebigen anderen Text zu markieren.

Die Einfügeposition wird im Argument pos angegeben. Der neue Eintrag wird vor dem in pos angegebenen Eintrag eingefügt. Dies kann eine absolute Indexposition ab 0 für den ersten Eintrag oder einer der folgenden Sonderwerte sein:

Top

Als ersten Eintrag einfügen.

Active

Vor dem aktiven Eintrag einfügen. Wenn es keinen aktiven Eintrag gibt, wird der Eintrag ganz oben in die Liste eingefügt.

Bottom

Als letzten Eintrag einfügen.

Wenn pos größer oder gleich der Anzahl der Einträge in der Listenansicht ist, wird der Eintrag als letzter Eintrag eingefügt.

Hat die Listenansicht sortierbare Spalten, wird pos ignoriert und der Eintrag wird automatisch in die Listenansicht einsortiert, je nachdem welche Spalte aktuell den Sortierfokus hat. Siehe Listview.SortColumn für Details.

Listview.Insert gibt die Position des neu eingefügten Eintrags zurück. Dies ist besonders nützlich, wenn die Listenansicht sortierbare Spalten hat, weil in diesem Fall nicht einfach berechnen kann, wo der Eintrag in der Listenansicht landen wird.

Beachten Sie, dass unter AmigaOS und kompatiblen die Unterstützung von Symbolen nur mit MUI 4.0 oder höher verfügbar ist.

id

ID des Listview-Objekts

pos

Position als Absolut- oder Sonderwert einfügen (siehe oben)

icon1

optional: Symbol für die erste Spalte; diese muss nur übergeben werden, wenn die Spalte das Icon-Attribut gesetzt hat; beachten Sie, dass dies ein numerischer Identifikator sein muss und automatisch generierte IDs in diesem Fall nicht gültig sind

column1$

Eintrag zum Einfügen in die erste Spalte

...

weitere Einträge bei mehrspaltiger Listenansicht

pos

Position des neu eingefügten Eintrags (ab 0)