wcInsertItem() 関数

指定した文字列をリスト ボックスまたはコンボ ボックスのリストの指定した位置に挿入します。wcAddItem() 関数とは異なり、ソートされたリスト ボックスまたはコンボ ボックスとして作成された場合でも、wcInsertItem() 関数はリストをソートしません。

カテゴリ

ウィンドウ コントロール

構文

[ErrorNumber=]wcInsertItem("ControlName", ItemPosition, "Message");

パラメータ

ControlName

ウィンドウ コントロール オブジェクトの名前。例：ListBox_1実際の文字列またはメッセージ型タグ変数です。

ItemPosition

アイテムが追加される位置を示す数。このパラメータが -1 の場合、文字列はリストの最後に追加されます。数値または整数型タグ変数です。

Message

ItemPosition で指定した位置に挿入する文字列が含まれます。実際の文字列またはメッセージ型タグ変数です。

備考

返されるエラー番号のリストについては、「ウィンドウ コントロール エラー メッセージを理解する」を参照してください。

適用対象

リスト ボックスとコンボ ボックス

例

アクション スクリプトが実行されると、以下のステートメントにより、"Blueberry" という新しいアイテムが、リスト ボックスの先頭から 4 番目の場所に挿入されます。

wcInsertItem("ListBox_1", 4, "Blueberry");

参照項目

wcAddItem()