ListBox.TopIndex プロパティ
ListBox に最初に表示される項目のインデックスを取得または設定します。
名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文
'宣言
Public Property TopIndex As Integer
'使用
Dim instance As ListBox
Dim value As Integer
value = instance.TopIndex
instance.TopIndex = value
public int TopIndex { get; set; }
public:
property int TopIndex {
int get ();
void set (int value);
}
/** @property */
public int get_TopIndex ()
/** @property */
public void set_TopIndex (int value)
public function get TopIndex () : int
public function set TopIndex (value : int)
プロパティ値
コントロールに最初に表示される項目の 0 から始まるインデックス番号。
解説
初期状態では、インデックス位置 0 の項目が ListBox の表示領域の先頭に示されます。ListBox の内容がスクロールされると、別の項目がコントロールの表示領域の先頭に示されることになります。このプロパティを使用して、ListBox の ListBox.ObjectCollection 内にある、現在コントロールの表示領域の先頭に示されている項目のインデックスを取得できます。このプロパティを使用すると、コントロールの表示領域の先頭に当たるリスト部分に項目を配置することもできます。
使用例
SelectedIndex プロパティと TopIndex プロパティを使用し、現在選択されている項目を ListBox の表示領域内の項目リストの先頭に移動する方法を次のコード例に示します。さらに、System.Windows.Forms.ListBox.ObjectCollection クラスの RemoveAt メソッドを使用して項目を削除する方法、ClearSelected メソッドを使用してすべての項目の選択を解除する方法についても示します。このコードは最初に、ListBox で現在選択されている項目をリストの先頭に移動します。このコードは次に、現在選択されている項目より前にある項目をすべて削除し、ListBox 内の選択をすべて解除します。この例では、項目を含む ListBox がフォームに追加されていて、いずれかの項目が ListBox で現在選択されている必要があります。
Private Sub RemoveTopItems()
' Determine if the currently selected item in the ListBox
' is the item displayed at the top in the ListBox.
If listBox1.TopIndex <> listBox1.SelectedIndex Then
' Make the currently selected item the top item in the ListBox.
listBox1.TopIndex = listBox1.SelectedIndex
End If
' Remove all items before the top item in the ListBox.
Dim x As Integer
For x = listBox1.SelectedIndex - 1 To 0 Step -1
listBox1.Items.RemoveAt(x)
Next x
' Clear all selections in the ListBox.
listBox1.ClearSelected()
End Sub 'RemoveTopItems
private void RemoveTopItems()
{
// Determine if the currently selected item in the ListBox
// is the item displayed at the top in the ListBox.
if (listBox1.TopIndex != listBox1.SelectedIndex)
// Make the currently selected item the top item in the ListBox.
listBox1.TopIndex = listBox1.SelectedIndex;
// Remove all items before the top item in the ListBox.
for (int x = (listBox1.SelectedIndex -1); x >= 0; x--)
{
listBox1.Items.RemoveAt(x);
}
// Clear all selections in the ListBox.
listBox1.ClearSelected();
}
private:
void RemoveTopItems()
{
// Determine if the currently selected item in the ListBox
// is the item displayed at the top in the ListBox.
if ( listBox1->TopIndex != listBox1->SelectedIndex )
// Make the currently selected item the top item in the ListBox.
listBox1->TopIndex = listBox1->SelectedIndex;
// Remove all items before the top item in the ListBox.
for ( int x = (listBox1->SelectedIndex - 1); x >= 0; x-- )
{
listBox1->Items->RemoveAt( x );
}
// Clear all selections in the ListBox.
listBox1->ClearSelected();
}
private void RemoveTopItems()
{
// Determine if the currently selected item in the ListBox
// is the item displayed at the top in the ListBox.
if (listBox1.get_TopIndex() != listBox1.get_SelectedIndex()) {
// Make the currently selected item the top item in the ListBox.
listBox1.set_TopIndex(listBox1.get_SelectedIndex());
}
// Remove all items before the top item in the ListBox.
for (int x = listBox1.get_SelectedIndex() - 1; x >= 0; x--) {
listBox1.get_Items().RemoveAt(x);
}
// Clear all selections in the ListBox.
listBox1.ClearSelected();
} //RemoveTopItems
プラットフォーム
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0