ListViewItem.Tag Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um objeto que contém dados a serem associados ao item.
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
Valor da propriedade
Um objeto que contém informações associadas ao item.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como inicializar um ListViewItem e definir as Tag propriedades e Text . Para executar este exemplo, coloque o código a seguir em um formulário que contenha um ListView chamado e chame InitializeListViewItems
do construtor do formulário ou Load do método de ListView1
tratamento de eventos.
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
Comentários
A Tag propriedade pode ser usada para armazenar qualquer objeto que você deseja associar a um item. Embora você possa armazenar qualquer item, a Tag propriedade normalmente é usada para armazenar informações de cadeia de caracteres sobre o item, como um identificador exclusivo ou a posição de índice dos dados do item em um banco de dados.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de