ListView ActiveX コントロール

ListItems

.ListItems : IListItems   

このプロパティは ListItem にアクセスします。ListItem は Listview 内の行を表し、次のプロパティとメソッドが用意されています。

.ListItems プロパティ:

.ListItems.Count : integer 

ListView コントロール内の ListItem の数を取得/設定します。

.ListItems[IndexList] : IListItem, read-only 

インデックスで指定された ListItem を返します。インデックスの基数は 1 です。

.ListItems メソッド:

.ListItems.Add Index:undefined Key:undefined Text:undefined Icon:undefined SmallIcon:undefined 

ListView コントロールに新しい ListItem を追加します。

.ListItems.Clear() 

ListItem を消去します。すべての ListItem が ListView から削除されます。

.ListItems.Remove Index:undefined 

インデックスで指定された ListItem を削除します。インデックスの基数は 1 です。

ColumnHeaders

.ColumnHeaders : IColumnHeaders 

このプロパティは、ListView の列ヘッダにアクセスします。

.ColumnHeaders プロパティ:

.Count : integer 

ListView コントロール内の列ヘッダの数を取得/設定します。

.Item[Index:undefined] : IColumnHeader, read-only 

インデックスで指定された列ヘッダを ListView コントロールから取得します。インデックスの基数は 1 です。

単一列ヘッダのプロパティのリストについては「ColumnHeader のプロパティとメソッド」を参照してください。

.ColumnHeaders メソッド:

.Clear() 

列ヘッダを消去します。すべての列ヘッダが ListView から削除されます。

.Remove Index:undefined 

インデックスで指定された列ヘッダを削除します。インデックスの基数は 1 です。

._NewEnum() 

戻り値のタイプがサポートされていません。

.Add Index:undefined Key:undefined Text:undefined Width:undefined Alignment:undefined Icon:undefined 

ListView コントロールに新しい列を追加します。

.HideColumnHeaders : Boolean 

このプロパティによって、列ヘッダを有効と無効を切り替えます。true に設定した場合、列ヘッダは非表示になります。false に設定した場合、列ヘッダは表示されます。 .View プロパティが #lvwReport に設定されている場合にのみ、列ヘッダを使用できます。

.AllowColumnReorder : Boolean 

true に設定した場合、ユーザは列をドラッグして、順序を指定することができます。false(既定値)に設定した場合、列の順序はロックされ、インタラクティブに変更できません

ListView のレイアウト:

.View: ListViewConstants( #lvwIcon | #lvwSmallIcon | #lvwList | #lvwReport ) 

ListView コントロールのビュー タイプを取得/設定します。

.Appearance : AppearanceConstant( #ccFlat | #cc3D ) 

ListView コントロールの外観を取得/設定します。#cc3D が既定値です。

.BorderStyle : BorderStyleConstants( #ccNone | #ccFixedSingle ) 

.Appearance が #ccFlat に設定されている場合に境界スタイルをコントロールします。 #ccFixedSingle に設定した場合、単一ピクセルの境界線が ListView の周囲に描かれます。

.Arrange : ListArrangeConstants( #lvwNone | #lvwAutoLeft | #lvwAutoTop ) 

ListView コントロールの配置をコントロールします。既定値は #lvwNone です。

.DropHighlight : IListItem 

ListItem をこのプロパティに割り当てると、この ListItem はハイライト表示されます(選択されていることを示していますが、選択された状態を示すフラグは設定されません)。このハイライトは、選択ハイライトには影響されません。DropHighlight が再び undefined に設定されるまで、指定された ListItem はハイライト表示されます。

以下のスクリーンショットでは、Teapot01 と表された ListItem は DropHighlight に割り当てられたもので、Box01 と表された ListItem はマウスで選択されたものです。

.LabelEdit: ListLabelEditConstants( #lvwAutomatic | #lvwManual ) 

ラベル(これが ListItem の最初の列のテキスト)の編集をコントロールします。既定値は #lvwAutomatic です。

#lvwAutomatic に設定した場合、ユーザはこの項目をクリックして選択してからもう一度ラベル位置でクリックすると、テキスト フィールドが開き、任意のテキストを入力できます。

#lvwManual に設定した場合、開発者が .StartLabelEdit() メソッドを使用したときにのみ、ラベル編集を開始できます。

.LabelWrap : Boolean 

ラベル ラップをコントロールします。

.Checkboxes : Boolean 

true に設定した場合、各 ListItem の最初の列にチェックボックスが表示されます。false(既定値)に設定した場合、ListItem ラベルだけが表示されます。

.Enabled : Boolean 

既定値の true に設定した場合は、ListItems の選択、ラベルの編集、チェックボックスのチェック、列幅の調整などができます。false に設定すると、ListItems は「フリーズ」され、どのような方法でも変更できなくなります。

.ForeColor : OLE_COLOR 

ListView の描画に使用するフォアグラウンド(テキスト)カラーをコントロールします。

.BackColor : OLE_COLOR 

ListView の描画に使用するバックグラウンド カラーをコントロールします。

以下のスクリーンショットには、既定の白色のバックグラウンド(.BackColor プロパティを設定しない場合)、.BackColor = color 225 215 210、.BackColor = color 215 225 210、および .BackColor = color 210 215 225 の各例を示しています。

.GridLines : Boolean 

false(既定値)に設定した場合、グリッド線は描かれません。true に設定した場合、行および列を区切るグリッド線が描かれます。

.FlatScrollBar : Boolean 

false(既定値)に設定した場合、スクロールバーが表示されます。true に設定した場合、スクロールバーは表示されません。矢印キーを使用して選択を移動すれば上下方向にスクロールできますが、水平方向にはスクロールできません。

.Picture : IPictureDisp 

バックグラウンドに画像を割り当てることができます。IPuctureDisp 値として ActiveX コントロールに画像を渡す方法の詳細については、「loadPicture」を参照してください。

以下の例は、Photoshop で作成し、24 bit の BMP ファイルでディスクに保存された 500 x 200 ピクセル サイズの黄色から赤色へのグラデーション画像を、次の行を使用して.Picture プロパティに渡したものです。

lv.picture = loadPicture "c:/3dsmax6/images/activex_gradient.bmp"

.PictureAlignment : ListPictureAlignmentConstants( #lvwTopLeft | #lvwTopRight | #lvwBottomLeft | #lvwBottomRight | #lvwCenter | #lvwTile ) 

.Picture プロパティに割り当てられた画像の位置合わせをコントロールします。

.TextBackground : ListTextBackgroundConstants( #lvwTransparent | #lvwOpaque ) 

テキスト バックグラウンドの外観をコントロールします。#lvwOpaque に設定した場合、上の例は次のように表示されます。

.Font : IFontDisp 

使用されるフォントをコントロールする MSDisplatch 値を返します。MAXScript では設定できません。

選択

.SelectedItem : IListItem, read-only, default:undefined 

選択された項目を返します。

.FullRowSelect : boolean 

true に設定した場合、項目またはサブ項目を選択すると、行全体が選択されます。false に設定した場合、ListItem (最初の列)だけが選択されます。

.MultiSelect : Boolean 

true に設定した場合、ユーザは複数の ListItem を同時に選択できます。false(既定値)に設定した場合、1 度に 1 つの ListItem しか選択できません。

.HideSelection : Boolean 

true に設定した場合、選択は表示されません。false に設定した場合、選択が表示されます。

.HotTracking : Boolean 

true に設定した場合、マウスが ListItems の上に移動すると、ListItems がハイライト表示されますfalse(既定値)に設定した場合、ListItem の上にマウスを移動しても影響はありません。

.HoverSelection : Boolean 

true に設定した場合、ListItem の上にマウスを移動したときに、自動的にこの ListItem が選択されます。false(既定値)に設定した場合、ユーザがマウスでクリックしたときにのみ、ListItem は選択されます。

マウス アクセス

.MouseIcon : IPictureDisp 

マウス アイコンを IPictureDisp 値で返します。MAXScript では設定できません。

.MousePointer : MousePointerConstants( #ccDefault | #ccArrow | #ccCross | #ccIBeam | #ccIcon | #ccSize | #ccSizeNESW | #ccSizeNS | #ccSizeNWSE | #ccSizeEW | #ccUpArrow | #ccHourglass | #ccNoDrop | #ccArrowHourglass | #ccArrowQuestion | #ccSizeAll | #ccCustom ) 

マウス ポインタが ListView Control の上にある場合のマウス ポインタのタイプを取得/設定します。スクリプト開発者は、このページで詳しく説明するマウス イベントを使用し、基礎となる内容か許可されているアクションによってマウス ポインタを変更できます。

ソート

.Sorted : Boolean 

false(既定値)に設定した場合、ListView.ListItems 配列に追加した順序で、ListItem が表示されます。

true に設定した場合、ListItem はアルファベット順に並べられます。既定では、最初の列のテキストを使用して昇順に並べられます。

.SortOrder : ListSortOrderConstants( #lvwAscending | #lvwDescending ) 

.Sort を true に設定した場合、このプロパティはソートの方向をコントロールします。

以下のスクリーンショットは、同じオブジェクトを、ソートなし、昇順ソート、および降順ソートで表示したものです。

.SortKey : integer 

MAXScript では設定できません。

アイコン

次のプロパティでは、ImageList ActiveX コントロールを割り当てて、ListView コントロールがアイコンとして使用する画像を指定することができます。

.View プロパティがそれぞれ #lvwIcon に設定されている場合にのみ、アイコンが表示されます。 #lvwSmallIcon

.Icons : IVBDataObject 

このプロパティを使用すると、アイコンをListView コントロールに割り当てることができます。アイコンとして使用する画像を含んだ IVBDataObject は「ImageList ActiveX コントロール」によって提供されます。

.SmallIcons : IVBDataObject, read-only, default:undefined 

このプロパティを使用すると、小さなアイコンを ListView コントロールに割り当てることができます。アイコンとして使用する画像を含んだ IVBDataObject は、ImageList ActiveX コントロール コントロールによって提供されます。

.ColumnHeaderIcons : IVBDataObject, read-only, default:undefined 

このプロパティを使用すると、ListView コントロールの列ヘッダにアイコンに割り当てることができます。アイコンとして使用する画像を含んだ IVBDataObject は、ImageList ActiveX コントロール コントロールによって提供されます。

ドラッグ アンド ドロップ

.OLEDragMode : OLEDragConstants( #ccOLEDragManual | #ccOLEDragAutomatic ) 

OLE ドラッグモードをコントロールします。

.OLEDropMode : OLEDropConstants( #ccOLEDropNone | #ccOLEDropManual ) 

OLE Drop モードをコントロールします。

OLE Windows メッセージ

.hWnd : OLE_HANDLE 

これは、Windows メッセージを ActiveX コントロールに送信する場合に必要となる ActiveX ハンドルです。詳細については、「Windows メッセージの送信」を参照してください。

メソッド:

.FindItem sz:string Where:undefined Index:undefined fPartial:undefined 

.GetFirstVisible() 

.HitTest x:float y:float 

.StartLabelEdit() 

.OLEDrag() 

.Refresh() 

イベント

on <control_name> BeforeLabelEdit Cancel:integer do ( ... ) 

ラベル編集を開始する前に呼び出されます。

on <control_name> AfterLabelEdit Cancel:integer NewString:string do ( ... ) 

ラベル編集を終了した後に呼び出されます。

on <control_name> ColumnClick ColumnHeader:ColumnHeader do ( ... ) 

ユーザが列ヘッダをクリックしたときに呼び出されます。ColumnHeader 引数には、クリックされた ColumnHeader が含まれます。ColumnHeader には、インデックスや位置合わせコントロールなどの固有のプロパティがあります。詳細は、「ColumnHeader のプロパティとメソッド」を参照してください。

on <control_name> ItemClick Item:ListItem do ( ... ) 

ユーザが ListItem をクリックしたときに呼び出されます。この項目引数には、クリックされた行の、0 を基数としたインデックスが含まれます。

キーボードおよびマウス クリック イベント

on <control_name> KeyDown KeyCode:integer Shift:integer do ( ... ) 

ユーザがキーを押したときに呼び出されます。KeyCode 引数には押されたキーの整数コードが含まれ、Shift 引数には[Shift]、[Ctrl]、および[Alt]キーが押されているかどうかを示すビットから成る整数値が含まれます。ビット 1 が[Shift]キー、ビット 2 が[Ctrl]キー、ビット 3 が[Alt]キーを表します。

0 - モディファイヤ キーは押されていません。

1 - 左または右の[Shift]キーが押されました。

2 - 左または右の[Ctrl]キーが押されました。

3 - [Ctrl] + [Shift]キーが同時に押されました。

4 - 左または右の[Alt]キーが押されました。

6 - [Ctrl] + [Alt]キーが同時に押されました。

7 - [Ctrl]、[Alt]、[Shift]キーが同時に押されました。

on lv_objects keyDown theKeyCode theShiftState do
(
format "Key Code is %, Shift State is %\n" theKeyCode theShiftState
)
--where lv_objects is the name of the ActiveX ListView,
--theKeyCode and theShiftState are user-defined variable names.

on <control_name> KeyUp KeyCode:integer Shift:integer do ( ... ) 

ユーザがキーを放したときに呼び出されます。KeyCode 引数には放したキーの整数コードが含まれ、Shift 引数には[Shift]、[Ctrl]、および[Alt]キーが押されているかどうかを示すビットから成る整数値が含まれます。上記を参照してください。

on <control_name> KeyPress KeyAscii:integer do ( ... ) 

ユーザがキーを押したときに呼び出されます。KeyAscii 引数には、押されたキーの ASCII 整数コードが含まれます。たとえば、[スペース](Space)を押すと 32 が、[Shift]+[A]を押すと 65 が返されます。

on <control_name> MouseDown Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... ) 

ユーザがマウスで ListItem をクリックしたときに呼び出されます。

Button 引数には、マウスのボタンに対応するビットから成る整数値が含まれます。ビット 1 は左マウス ボタンを、ビット 2 は右マウス ボタンを、ビット 3 は中央のマウス ボタンまたはホイールを表します。

1 - 左マウス ボタンが押されました。

2 - 右マウス ボタンが押されました。

4 - 中央のマウス ボタンまたはホイールが押されました。

rollout test "Test"
(
activeXControl lv "MSComctlLib.ListViewCtrl" height:100 width:100
on lv MouseDown Button Shift x y do
format "Button: %, Shift: %, xy: %,%\n" Button Shift x y
)
createDialog test

on <control_name> MouseMove Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... ) 

ユーザがマウスを ListView コントロール内に移動したときに呼び出されます。

Button 引数には、マウスのボタンに対応するビットから成る整数値が含まれます。ビット 1 は左マウス ボタンを、ビット 2 は右マウス ボタンを、ビット 3 は中央のマウス ボタンまたはホイールを表します。

1 - 左マウス ボタンが押されました。

2 - 右マウス ボタンが押されました。

4 - 中央のマウス ボタンまたはホイールが押されました。

--This script will print the mouse values
--while you move the mouse inside the ListView control
rollout test "Test"
(
activeXControl lv "MSComctlLib.ListViewCtrl" height:100 width:100
on lv MouseMove Button Shift x y do
format "Button: %, Shift: %, xy: %,%\n" Button Shift x y
)
createDialog test

on <control_name> MouseUp Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... ) 

ユーザが ListView コントロール上でマウスを放したときに呼び出されます。

Button 引数には、マウスのボタンに対応するビットから成る整数値が含まれます。ビット 1 は左マウス ボタンを、ビット 2 は右マウス ボタンを、ビット 3 は中央のマウス ボタンまたはホイールを表します。

1 - 左マウス ボタンが押されました。

2 - 右マウス ボタンが押されました。

4 - 中央のマウス ボタンまたはホイールが押されました。

Shift 引数には、先に説明したとおり、[Shift]、[Ctrl]、および[Alt]キーの状態が含まれます。

x および y 引数には、ListView ピクセル座標(Twips ではありません)におけるクリックの位置が含まれます。ここで、0,0 は ListView コントロールの左上隅になります。

rollout test "Test"
(
activeXControl lv "MSComctlLib.ListViewCtrl" height:100 width:100
on lv MouseUp Button Shift x y do
format "Button: %, Shift: %, xy: %,%\n" Button Shift x y 
)
createDialog test

on <control_name> Click do ( ... ) 

ユーザが ListView コントロール内でクリックしたときに呼び出されます。このイベントは特定の ListItem を返すわけではありませんが、すべての ListItem の選択状態や他のプロパティを問い合わせる場合に使用できます。これは、ユーザが ListView をクリックしたという一般的な通知であり、イベントによって行われる実際のアクションは、スクリプト開発者が指定できます。

on <control_name> DblClick do ( ... ) 

ユーザが ListView コントロール内でダブルクリックしたときに呼び出されます。

on <control_name> ItemCheck Item:ListItem do ( ... ) 

ユーザが ListItem のチェックボックスの状態が変更したときに呼び出されます(プロパティ .checkboxes = true であり、利用できる場合)。

Item 引数には、チェックボックスが変更された ListItem が含まれます。続いて、この項目の .checked プロパティにアクセスすると、新しい状態にアクセスできます。また、他のすべての ListItem プロパティにもアクセスできます。

OLE ドラッグ アンド ドロップ イベント

on <control_name> OLEStartDrag &Data:DataObject &AllowedEffects:integer do ( ... ) 

ユーザが ListView コントロールからドラッグを始めたときに呼び出されます。

on <control_name> OLEGiveFeedback &Effect:integer &DefaultCursors:boolean do ( ... ) 

ユーザが ListView コントロールからドラッグを始めたときに呼び出されます。

on <control_name> OLESetData &Data:DataObject &DataFormat:integer do ( ... ) 

on <control_name> OLECompleteDrag &Effect:integer do ( ... ) 

on <control_name> OLEDragOver &Data:DataObject &Effect:integer &Button:integer &Shift:integer &x:float &y:float &State:integer do ( ... ) 

on <control_name> OLEDragDrop &Data:DataObject &Effect:integer &Button:integer &Shift:integer &x:float &y:float do ( ... ) 

ListItem のプロパティとメソッド

ListItem は、 .ListItems.Add() メソッドを使用して作成できます。また、上記のように 1 を基数としたインデックスで指定したアクセスを使用してアクセスできます。すべての ListItem には、次のプロパティとメソッドがあります。

.Text : string 

.Ghosted : Boolean 

.Height : float 

.Icon : undefined 

.Index : integer 

.Key : string 

.Selected : Boolean 

.SmallIcon : undefined 

.Tag : undefined 

.Top : float 

.Left : float 

.Width : float 

.ListSubItems : IListSubItems 

--to access the second sub-item of the first item in
--a ListView Control stored in the variable lv,
--you could use:
lv.listItems[1].listSubItems[2]

.Checked : Boolean 

.ForeColor : OLE_COLOR 

.ToolTipText : string 

.Bold : Boolean 

.CreateDragImage() 

.EnsureVisible() 

ListSubItem のプロパティとメソッド

ListSubItem は、 .ListItems.Add() メソッドを使用して作成できます。また、上記のように 1 を基数としたインデックスで指定したアクセスを使用してアクセスできます。すべての ListItem には、次のプロパティがあります。

.Text : string 

.ForeColor : OLE_COLOR 

.Bold : boolean 

.ToolTipText : string 

.Index : integer 

.Key : string 

.Tag : undefined 

.ReportIcon : undefined 

ColumnHeader のプロパティとメソッド

すべての ColumnHeader には、次のプロパティがあります。

.Text : string 

.Alignment : ListColumnAlignmentConstants( #lvwColumnLeft | #lvwColumnRight | #lvwColumnCenter ) 

.Index : integer 

.Key : string 

.Left : float 

.SubItemIndex : integer 

.Tag : undefined 

.Width : float 

.Icon : undefined 

.Position : integer