ListViewItem.ListViewSubItemCollection.Add Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till en underwebbplats i samlingen med underwebbplatser.
Överlagringar
| Name | Description |
|---|---|
| Add(String) |
Lägger till en underwebbplats i samlingen med angiven text. |
| Add(ListViewItem+ListViewSubItem) |
Lägger till en befintlig ListViewItem.ListViewSubItem i samlingen. |
| Add(String, Color, Color, Font) |
Lägger till ett underobjekt i samlingen med angiven text, förgrundsfärg, bakgrundsfärg och teckensnittsinställningar. |
Add(String)
Lägger till en underwebbplats i samlingen med angiven text.
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text);
member this.Add : string -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (text As String) As ListViewItem.ListViewSubItem
Parametrar
- text
- String
Texten som ska visas för underwebbplatsen.
Returer
Det ListViewItem.ListViewSubItem som lades till i samlingen.
Exempel
I följande kodexempel skapas en ListView kontroll med tre ListViewItem angivna objekt och tre ListViewItem.ListViewSubItem objekt angivna för varje objekt. Exemplet skapar ColumnHeader också objekt för att visa underwebbplatserna i informationsvyn. Två ImageList objekt skapas också i kodexemplet för att tillhandahålla bilder för objekten ListViewItem . Dessa ImageList objekt läggs till i LargeImageList egenskaperna och SmallImageList . I exemplet används följande egenskaper för att skapa ListView kontrollen:
Det här exemplet kräver att du har lagt till koden i en Form och anropar metoden som skapades i exemplet från konstruktorn eller någon annan metod i formuläret. Exemplet kräver också att avbildningar med namnet MySmallImage1, MySmallImage2, MyLargeImage1och MyLargeImage2 finns i rotkatalogen för enhet C.
private:
void CreateMyListView()
{
// Create a new ListView control.
ListView^ listView1 = gcnew ListView;
listView1->Bounds = Rectangle(Point(10,10),System::Drawing::Size( 300, 200 ));
// Set the view to show details.
listView1->View = View::Details;
// Allow the user to edit item text.
listView1->LabelEdit = true;
// Allow the user to rearrange columns.
listView1->AllowColumnReorder = true;
// Display check boxes.
listView1->CheckBoxes = true;
// Select the item and subitems when selection is made.
listView1->FullRowSelect = true;
// Display grid lines.
listView1->GridLines = true;
// Sort the items in the list in ascending order.
listView1->Sorting = SortOrder::Ascending;
// Create three items and three sets of subitems for each item.
ListViewItem^ item1 = gcnew ListViewItem( "item1",0 );
// Place a check mark next to the item.
item1->Checked = true;
item1->SubItems->Add( "1" );
item1->SubItems->Add( "2" );
item1->SubItems->Add( "3" );
ListViewItem^ item2 = gcnew ListViewItem( "item2",1 );
item2->SubItems->Add( "4" );
item2->SubItems->Add( "5" );
item2->SubItems->Add( "6" );
ListViewItem^ item3 = gcnew ListViewItem( "item3",0 );
// Place a check mark next to the item.
item3->Checked = true;
item3->SubItems->Add( "7" );
item3->SubItems->Add( "8" );
item3->SubItems->Add( "9" );
// Create columns for the items and subitems.
// Width of -2 indicates auto-size.
listView1->Columns->Add( "Item Column", -2, HorizontalAlignment::Left );
listView1->Columns->Add( "Column 2", -2, HorizontalAlignment::Left );
listView1->Columns->Add( "Column 3", -2, HorizontalAlignment::Left );
listView1->Columns->Add( "Column 4", -2, HorizontalAlignment::Center );
//Add the items to the ListView.
array<ListViewItem^>^temp1 = {item1,item2,item3};
listView1->Items->AddRange( temp1 );
// Create two ImageList objects.
ImageList^ imageListSmall = gcnew ImageList;
ImageList^ imageListLarge = gcnew ImageList;
// Initialize the ImageList objects with bitmaps.
imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage1.bmp" ) );
imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage2.bmp" ) );
imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage1.bmp" ) );
imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage2.bmp" ) );
//Assign the ImageList objects to the ListView.
listView1->LargeImageList = imageListLarge;
listView1->SmallImageList = imageListSmall;
// Add the ListView to the control collection.
this->Controls->Add( listView1 );
}
private void CreateMyListView()
{
// Create a new ListView control.
ListView listView1 = new ListView();
listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));
// Set the view to show details.
listView1.View = View.Details;
// Allow the user to edit item text.
listView1.LabelEdit = true;
// Allow the user to rearrange columns.
listView1.AllowColumnReorder = true;
// Display check boxes.
listView1.CheckBoxes = true;
// Select the item and subitems when selection is made.
listView1.FullRowSelect = true;
// Display grid lines.
listView1.GridLines = true;
// Sort the items in the list in ascending order.
listView1.Sorting = SortOrder.Ascending;
// Create three items and three sets of subitems for each item.
ListViewItem item1 = new ListViewItem("item1",0);
// Place a check mark next to the item.
item1.Checked = true;
item1.SubItems.Add("1");
item1.SubItems.Add("2");
item1.SubItems.Add("3");
ListViewItem item2 = new ListViewItem("item2",1);
item2.SubItems.Add("4");
item2.SubItems.Add("5");
item2.SubItems.Add("6");
ListViewItem item3 = new ListViewItem("item3",0);
// Place a check mark next to the item.
item3.Checked = true;
item3.SubItems.Add("7");
item3.SubItems.Add("8");
item3.SubItems.Add("9");
// Create columns for the items and subitems.
// Width of -2 indicates auto-size.
listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);
//Add the items to the ListView.
listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});
// Create two ImageList objects.
ImageList imageListSmall = new ImageList();
ImageList imageListLarge = new ImageList();
// Initialize the ImageList objects with bitmaps.
imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));
//Assign the ImageList objects to the ListView.
listView1.LargeImageList = imageListLarge;
listView1.SmallImageList = imageListSmall;
// Add the ListView to the control collection.
this.Controls.Add(listView1);
}
Private Sub CreateMyListView()
' Create a new ListView control.
Dim listView1 As New ListView()
listView1.Bounds = New Rectangle(New Point(10, 10), New Size(300, 200))
' Set the view to show details.
listView1.View = View.Details
' Allow the user to edit item text.
listView1.LabelEdit = True
' Allow the user to rearrange columns.
listView1.AllowColumnReorder = True
' Display check boxes.
listView1.CheckBoxes = True
' Select the item and subitems when selection is made.
listView1.FullRowSelect = True
' Display grid lines.
listView1.GridLines = True
' Sort the items in the list in ascending order.
listView1.Sorting = SortOrder.Ascending
' Create three items and three sets of subitems for each item.
Dim item1 As New ListViewItem("item1", 0)
' Place a check mark next to the item.
item1.Checked = True
item1.SubItems.Add("1")
item1.SubItems.Add("2")
item1.SubItems.Add("3")
Dim item2 As New ListViewItem("item2", 1)
item2.SubItems.Add("4")
item2.SubItems.Add("5")
item2.SubItems.Add("6")
Dim item3 As New ListViewItem("item3", 0)
' Place a check mark next to the item.
item3.Checked = True
item3.SubItems.Add("7")
item3.SubItems.Add("8")
item3.SubItems.Add("9")
' Create columns for the items and subitems.
' Width of -2 indicates auto-size.
listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left)
listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left)
listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left)
listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center)
'Add the items to the ListView.
listView1.Items.AddRange(New ListViewItem() {item1, item2, item3})
' Create two ImageList objects.
Dim imageListSmall As New ImageList()
Dim imageListLarge As New ImageList()
' Initialize the ImageList objects with bitmaps.
imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage1.bmp"))
imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage2.bmp"))
imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage1.bmp"))
imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage2.bmp"))
'Assign the ImageList objects to the ListView.
listView1.LargeImageList = imageListLarge
listView1.SmallImageList = imageListSmall
' Add the ListView to the control collection.
Me.Controls.Add(listView1)
End Sub
Kommentarer
Med den Add här versionen av metoden kan du lägga till en underwebbplats i samlingen genom att ange texten i underwebbplatsen. När den här metoden anropas skapas en ny ListViewItem.ListViewSubItem med den angivna texten. Du kan sedan använda det ListViewItem.ListViewSubItem som returneras av den här metoden för att ange egenskaper och anropa metoder för att ändra underobjektet. Om du redan har en befintlig ListViewItem.ListViewSubItem som du vill lägga till i samlingen kan du använda den version av Add metoden som accepterar en ListViewItem.ListViewSubItem som en parameter, eller använda Insert metoden om du vill lägga till underobjektet på en viss position i samlingen.
Se även
Gäller för
Add(ListViewItem+ListViewSubItem)
Lägger till en befintlig ListViewItem.ListViewSubItem i samlingen.
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::Windows::Forms::ListViewItem::ListViewSubItem ^ item);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add(System.Windows.Forms.ListViewItem.ListViewSubItem item);
member this.Add : System.Windows.Forms.ListViewItem.ListViewSubItem -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItem
Parametrar
Att ListViewItem.ListViewSubItem lägga till i samlingen.
Returer
Det ListViewItem.ListViewSubItem som lades till i samlingen.
Kommentarer
Du kan använda den Add här versionen av metoden för att lägga till en befintlig ListViewItem.ListViewSubItem i samlingen. Den här metoden används vanligtvis för att återanvända befintliga underwebbplatser från andra ListViewItem objekt. Objekt som läggs till i samlingen infogas i slutet av listan. Om du vill infoga ett objekt i samlingen vid en viss position använder du Insert metoden . Om du vill lägga till en matris med befintliga ListViewItem.ListViewSubItem objekt kan du använda den version av AddRange metoden som accepterar en matris med ListViewItem.ListViewSubItem objekt som en parameter.
Se även
Gäller för
Add(String, Color, Color, Font)
Lägger till ett underobjekt i samlingen med angiven text, förgrundsfärg, bakgrundsfärg och teckensnittsinställningar.
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
member this.Add : string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItem
Parametrar
- text
- String
Texten som ska visas för underwebbplatsen.
Returer
Det ListViewItem.ListViewSubItem som lades till i samlingen.
Kommentarer
Med den Add här versionen av metoden kan du lägga till en underwebbplats i samlingen genom att ange texten i underwebbplatsen. Dessutom kan du med den Add här versionen av metoden ange den inledande förgrundsfärgen, bakgrundsfärgen och teckensnittet för underwebbplatstexten. När den här metoden anropas skapas en ny ListViewItem.ListViewSubItem med den angivna texten. Du kan sedan använda det ListViewItem.ListViewSubItem som returneras av den här metoden för att ange egenskaper och anropa metoder för att ändra underobjektet. Om du redan har en befintlig ListViewItem.ListViewSubItem som du vill lägga till i samlingen kan du använda den version av Add metoden som accepterar en ListViewItem.ListViewSubItem som en parameter, eller använda Insert metoden om du vill lägga till underobjektet på en viss position i samlingen.
Note
Som standard använder underwebbplatser förgrundsfärgen, bakgrundsfärgen och teckensnittet som angetts för det överordnade objektet. Ange egenskapen ListViewItem.UseItemStyleForSubItems till false för att förhindra att de överordnade objektformaten överskrider underobjektsformaten.