バージョン 6.3.3
 —  ダイアログコンポーネントリファレンス  —

リストボックスコントロール

このドキュメントでは、次のトピックについて説明します。


説明

リストボックスコントロールには多数のリストボックス項目が含まれ、エンドユーザーがここから 1 つ以上の項目を選択できます。 以下の方法で、リストボックスコントロールに項目を挿入できます。

Fill イベントを使用すると、ダイナミックに拡張するリストボックスコントロールを実装できます。

MULTI-SELECTION 属性は、リストボックスコントロールに対して、エンドユーザーが一度に選択できる項目数を 1 つにするか複数にするかを指定します。

注意:
リストボックスの子項目で SELECTED-SUCCESSOR を使用できるようにするには、リストボックスコントロールに対して MULTI-SELECTION = TRUE に設定する必要があります。

リストボックス項目 STRING をアルファベット順にソートするには、リストボックスコントロールの SORTED 属性を使用します。 リストボックス項目の STRING が変更されると、項目は再度自動的にソートされます。 その後、SUCCESSOR 属性で項目の一覧を順番に確認すると、新しいソート順が反映されます。

リストボックス項目に対して Click イベントまたは Double-Click イベントが発生すると、リストボックスコントロールはイベントを受け取ります。リストボックスコントロールのイベントハンドラは、リストボックスコントロールの SELECTED-SUCCESSOR 属性を照会して、クリックされた項目を特定できます。 複数のリストボックス項目が同時に選択された場合、次に選択されている項目は、前の項目の SELECTED-SUCCESSOR 属性を照会して特定できます。

Click イベントおよび Double-Click イベントに対してイベントハンドラを指定する場合、Click イベントハンドラは Double-Click イベントハンドラより先に実行されます。

これは、Click イベントハンドラが Double-Click イベントハンドラの実行を抑制している可能性があることを示します(SUPPRESS-DBL-CLICK-EVENT 属性)。

Top of page

リストボックスコントロールの属性

属性名 照会 設定/変更 属性 ウィンドウ
AUTOSELECT X X/X  
ACCELERATOR X X/X X
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
CONTEXT-MENU X X/X X
DIL-TEXT X X/X X
DRAG-MODE X X/X X
DROP-MODE X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
FIRST-VISIBLE-ITEM X X/X  
FOLLOWS X X/X  
FONT-HANDLE X X/X X
FOREGROUND-COLOUR-NAME X X/X X
FOREGROUND-COLOUR-VALUE X X/X X
HELP-ID X X/X X
LAST-CHILD X -/-  
MODIFIED X -/X  
MODIFIED-SUCCESSOR X -/-  
MULTI-SELECTION X X/- X
OWNER X X/-  
PARENT X X/-  
PREDECESSOR X -/-  
RECTANGLE-H X X/X X
RECTANGLE-W X X/X X
RECTANGLE-X X X/X X
RECTANGLE-Y X X/X X
ROW-COUNT X -/-  
RTL X -/- X
SELECTED-SUCCESSOR X -/-  
SORTED X X/- X
STYLE X -/- X
SUCCESSOR X -/-  
SUPPRESS-BEGIN-DRAG-EVENT X X/X  
SUPPRESS-CLICK-EVENT X X/X  
SUPPRESS-CLIPBOARD-STATUS-EVENT X X/X  
SUPPRESS-COPY-EVENT X X/X  
SUPPRESS-CUT-EVENT X X/X  
SUPPRESS-DBL-CLICK-EVENT X X/X  
SUPPRESS-DELETE-EVENT X X/X  
SUPPRESS-DRAG-DROP-EVENT X X/X  
SUPPRESS-DRAG-ENTER-EVENT X X/X  
SUPPRESS-DRAG-LEAVE-EVENT X X/X  
SUPPRESS-DRAG-OVER-EVENT X X/X  
SUPPRESS-END-DRAG-EVENT X X/X  
SUPPRESS-FILL-EVENT X X/X  
SUPPRESS-PASTE-EVENT X X/X  
SUPPRESS-UNDO-EVENT X X/X  
TOOLTIP X X/X  
TYPE X X/-  
VISIBLE X X/X X

Top of page

イベント

Begin-Drag イベントClick イベントClipboard-Status イベントCopy イベントCut イベントDelete イベントDouble-Click イベントDrag-Drop イベントDrag-Enter イベントDrag-Leave イベントDrag-Over イベントEnd-Drag イベントFill イベントPaste イベントUndo イベント(どのイベントも抑制される場合あり)。

Top of page