ListBox.GetSelected メソッド
指定した項目が選択されているかどうかを示す値を返します。
名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文
'宣言
Public Function GetSelected ( _
index As Integer _
) As Boolean
'使用
Dim instance As ListBox
Dim index As Integer
Dim returnValue As Boolean
returnValue = instance.GetSelected(index)
public bool GetSelected (
int index
)
public:
bool GetSelected (
int index
)
public boolean GetSelected (
int index
)
public function GetSelected (
index : int
) : boolean
パラメータ
- index
選択されているかどうかを確認する対象となる項目の 0 から始まるインデックス番号。
戻り値
指定した項目が ListBox 内で現在選択されている場合は true。それ以外の場合は false。
例外
例外の種類 | 条件 |
---|---|
index パラメータの値がゼロ未満か、ListBox.ObjectCollection クラスの Count プロパティの値以上です。 |
解説
このメソッドを使用すると、指定した項目が選択されているかどうかをすばやく確認できます。このメソッドは、複数選択の ListBox 内で特定の項目が選択されているときに、特定の操作を実行する必要がある場合に役立ちます。
使用例
GetSelected メソッドを使用して ListBox 内のどの項目が選択されているかを判別し、現在選択されていない項目を選択して、現在選択されている項目の選択を解除する方法を次のコード例に示します。この例では、SelectionMode プロパティを使用して ListBox で複数の項目の選択を許可する方法と、Sorted プロパティを使用して ListBox 内の項目を自動的に並べ替える方法についても示します。この例では、listBox1
という名前の ListBox がフォームに追加されており、この例で定義されている InitializeMyListBox
メソッドがフォームの Load イベントから呼び出される必要があります。
Private Sub InitializeMyListBox()
' Add items to the ListBox.
listBox1.Items.Add("A")
listBox1.Items.Add("C")
listBox1.Items.Add("E")
listBox1.Items.Add("F")
listBox1.Items.Add("G")
listBox1.Items.Add("D")
listBox1.Items.Add("B")
' Sort all items added previously.
listBox1.Sorted = True
' Set the SelectionMode to select multiple items.
listBox1.SelectionMode = SelectionMode.MultiExtended
' Select three initial items from the list.
listBox1.SetSelected(0, True)
listBox1.SetSelected(2, True)
listBox1.SetSelected(4, True)
' Force the ListBox to scroll back to the top of the list.
listBox1.TopIndex = 0
End Sub
Private Sub InvertMySelection()
Dim x As Integer
' Loop through all items the ListBox.
For x = 0 To listBox1.Items.Count - 1
' Determine if the item is selected.
If listBox1.GetSelected(x) = True Then
' Deselect all items that are selected.
listBox1.SetSelected(x, False)
Else
' Select all items that are not selected.
listBox1.SetSelected(x, True)
End If
Next x
' Force the ListBox to scroll back to the top of the list.
listBox1.TopIndex = 0
End Sub
private void InitializeMyListBox()
{
// Add items to the ListBox.
listBox1.Items.Add("A");
listBox1.Items.Add("C");
listBox1.Items.Add("E");
listBox1.Items.Add("F");
listBox1.Items.Add("G");
listBox1.Items.Add("D");
listBox1.Items.Add("B");
// Sort all items added previously.
listBox1.Sorted = true;
// Set the SelectionMode to select multiple items.
listBox1.SelectionMode = SelectionMode.MultiExtended;
// Select three initial items from the list.
listBox1.SetSelected(0,true);
listBox1.SetSelected(2,true);
listBox1.SetSelected(4,true);
// Force the ListBox to scroll back to the top of the list.
listBox1.TopIndex=0;
}
private void InvertMySelection()
{
// Loop through all items the ListBox.
for (int x = 0; x < listBox1.Items.Count; x++)
{
// Determine if the item is selected.
if(listBox1.GetSelected(x) == true)
// Deselect all items that are selected.
listBox1.SetSelected(x,false);
else
// Select all items that are not selected.
listBox1.SetSelected(x,true);
}
// Force the ListBox to scroll back to the top of the list.
listBox1.TopIndex=0;
}
private:
void InitializeMyListBox()
{
// Add items to the ListBox.
listBox1->Items->Add( "A" );
listBox1->Items->Add( "C" );
listBox1->Items->Add( "E" );
listBox1->Items->Add( "F" );
listBox1->Items->Add( "G" );
listBox1->Items->Add( "D" );
listBox1->Items->Add( "B" );
// Sort all items added previously.
listBox1->Sorted = true;
// Set the SelectionMode to select multiple items.
listBox1->SelectionMode = SelectionMode::MultiExtended;
// Select three initial items from the list.
listBox1->SetSelected( 0, true );
listBox1->SetSelected( 2, true );
listBox1->SetSelected( 4, true );
// Force the ListBox to scroll back to the top of the list.
listBox1->TopIndex = 0;
}
void InvertMySelection()
{
// Loop through all items the ListBox.
for ( int x = 0; x < listBox1->Items->Count; x++ )
{
// Select all items that are not selected,
// deselect all items that are selected.
listBox1->SetSelected( x, !listBox1->GetSelected( x ) );
}
listBox1->TopIndex = 0;
}
private void InitializeMyListBox()
{
// Add items to the ListBox.
listBox1.get_Items().Add("A");
listBox1.get_Items().Add("C");
listBox1.get_Items().Add("E");
listBox1.get_Items().Add("F");
listBox1.get_Items().Add("G");
listBox1.get_Items().Add("D");
listBox1.get_Items().Add("B");
// Sort all items added previously.
listBox1.set_Sorted(true);
// Set the SelectionMode to select multiple items.
listBox1.set_SelectionMode(SelectionMode.MultiExtended);
// Select three initial items from the list.
listBox1.SetSelected(0, true);
listBox1.SetSelected(2, true);
listBox1.SetSelected(4, true);
// Force the ListBox to scroll back to the top of the list.
listBox1.set_TopIndex(0);
} //InitializeMyListBox
private void InvertMySelection()
{
// Loop through all items the ListBox.
for (int x = 0; x < listBox1.get_Items().get_Count(); x++) {
// Determine if the item is selected.
if (listBox1.GetSelected(x) == true) {
// Deselect all items that are selected.
listBox1.SetSelected(x, false);
}
else {
// Select all items that are not selected.
listBox1.SetSelected(x, true);
}
}
// Force the ListBox to scroll back to the top of the list.
listBox1.set_TopIndex(0);
} //InvertMySelection
プラットフォーム
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