wcInsertItem (Funktion)

Fügt an einer bestimmten Position in einer Liste oder einem Kombinationsfeld einen neuen Eintrag ein. Anders als bei der Funktion wcAddItem() wird bei wcInsertItem() die Liste nicht neu sortiert, selbst wenn die Sortierung aktiviert ist.

Kategorie

Windows-Steuerelemente

Syntax

[Ergebniscode=]wcInsertItem("Steuerelement", Position, "Meldung");

Parameter

Steuerelement

Der Name des Windows-Steuerelements, Bsp.: ListenFeld_1. Zeichenfolge oder Meldungsvariable.

Position

Zahl, die angibt, an welcher Stelle der Eintrag eingefügt werden soll. Wenn dieser Parameter auf -1 gesetzt ist, wird die Zeichenfolge am Ende der Liste eingefügt. Beliebige Zahl oder Variable vom Typ "Integer".

Meldung

Die Zeichenfolge, die an der angegebenen Position eingefügt werden soll. Zeichenfolge oder Meldungsvariable.

Anmerkungen

Eine Liste der Ergebniscodes finden Sie unter Fehlermeldungen von Windows-Steuerelementen auswerten

Geltungsbereich

Listenfelder und Kombinationsfelder.

Beispiel(e)

Die folgende Anweisung fügt im angegebenen Listenfeld an der vierten Position von oben einen neuen Eintrag mit der Bezeichnung "Heidelbeere" ein.

wcInsertItem("ListenFeld_1", 4, "Heidelbeere");

Siehe auch

wcAddItem()