ListViewItem.Tag Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает объект, содержащий данные, сопоставленные данному элементу.
public:
property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object Tag { get; set; }
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object? Tag { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Tag : obj with get, set
Public Property Tag As Object
Значение свойства
Объект, содержащий данные, сопоставленные данному элементу.
- Атрибуты
Примеры
В следующем примере кода показано, как инициализировать ListViewItem и задать Tag свойства и Text . Чтобы выполнить этот пример, поместите следующий код в форму, содержащую ListView с именем ListView1
, и вызовите InitializeListViewItems
из конструктора формы или Load метода обработки событий.
private:
void InitializeListViewItems()
{
ListView1->View = View::List;
array<System::Windows::Forms::Cursor^>^favoriteCursors = {Cursors::Help,Cursors::Hand,Cursors::No,Cursors::Cross};
// Populate the ListView control with the array of Cursors.
System::Collections::IEnumerator^ myEnum = favoriteCursors->GetEnumerator();
while ( myEnum->MoveNext() )
{
System::Windows::Forms::Cursor^ aCursor = safe_cast<System::Windows::Forms::Cursor^>(myEnum->Current);
// Construct the ListViewItem object
ListViewItem^ item = gcnew ListViewItem;
// Set the Text property to the cursor name.
item->Text = aCursor->ToString();
// Set the Tag property to the cursor.
item->Tag = aCursor;
// Add the ListViewItem to the ListView.
ListView1->Items->Add( item );
}
}
private void InitializeListViewItems()
{
ListView1.View = View.List;
Cursor[] favoriteCursors = new Cursor[]{Cursors.Help,
Cursors.Hand, Cursors.No, Cursors.Cross};
// Populate the ListView control with the array of Cursors.
foreach ( Cursor aCursor in favoriteCursors )
{
// Construct the ListViewItem object
ListViewItem item = new ListViewItem();
// Set the Text property to the cursor name.
item.Text = aCursor.ToString();
// Set the Tag property to the cursor.
item.Tag = aCursor;
// Add the ListViewItem to the ListView.
ListView1.Items.Add(item);
}
}
Private Sub InitializeListViewItems()
ListView1.View = View.List
Dim aCursor As Cursor
Dim favoriteCursors() As Cursor = New Cursor() _
{Cursors.Help, Cursors.Hand, Cursors.No, Cursors.Cross}
' Populate the ListView control with the array of Cursors.
For Each aCursor In favoriteCursors
' Construct the ListViewItem object
Dim item As New ListViewItem
' Set the Text property to the cursor name.
item.Text = aCursor.ToString
' Set the Tag property to the cursor.
item.Tag = aCursor
' Add the ListViewItem to the ListView.
ListView1.Items.Add(item)
Next
End Sub
Комментарии
Свойство Tag можно использовать для хранения любого объекта, который требуется связать с элементом. Хотя вы можете сохранить любой элемент, Tag свойство обычно используется для хранения строковых сведений об элементе, таких как уникальный идентификатор или положение индекса данных элемента в базе данных.