TViewStyle indicates how a list view control displays its items.
TViewStyle = ( vsIcon, vsSmallIcon, vsList, vsReport );
enum TViewStyle { vsIcon, vsSmallIcon, vsList, vsReport };
ComCtrls
TViewStyle can have one of the following values:
Value |
Meaning |
vsIcon |
Each item appears as a full-sized icon with a label below it. The user can drag the items to any location in the list view window. |
vsSmallIcon |
Each item appears as a small icon with the label to the right of it. The user can drag the items to any location. |
vsList |
Each item appears as a small icon with a label to the right of it. Items are arranged in columns and cannot be dragged by the user. |
vsReport |
Each item appears on its own line with information arranged in columns. The leftmost column contains the small icon and label, and subsequent columns contain subitems as specified by the application. Unless ShowColumnHeaders is false, each column has a header. |
C++ Examples:
/* This example requires a TListView, a TImageList and a TComboBox. You will need to double click the image list and add several images to the image list prior to running the project. During the form’s OnCreate event handler, items for the List View control are created for each image in the Image List and the ImageIndex is assigned the number of the image within the ImageList. Two columns are created so that when ViewStyle is vsReport, you will have columns to view. Also within the form’s OnCreate event handler assign the ComboBox each of the four TViewStyle constants to the Items’ Objects property. You could also simply code this within a series of OnClick event handlers as, for instance, ListView1.->ViewStyle := vsIcon. */ void __fastcall TForm1::FormCreate(TObject *Sender) { TListItem *Item; TListColumn *Column; const char imagenames[3][20] = {"C++ Image", "Borland Image", "Delphi Image"}; const char Col2Array[3][40] = {"Documentation for the C++ icon.", "Borland icon.", "Delphi icon."}; // Create a ListView item for each image in the ImageList ListView1->SmallImages = ImageList1; ListView1->LargeImages = ImageList1; for (int i = 0; i < ImageList1->Count; i++) { Item = ListView1->Items->Add(); Item->Caption = imagenames[i]; Item->ImageIndex = i; Item->SubItems->Add(Col2Array[i]); } // Create two columns to show during viewing as vsReport Column = ListView1->Columns->Add(); Column->Caption = "Column 1"; Column->Width = 200; Column = ListView1->Columns->Add(); Column->Caption = "Column 2"; Column->Width = 200; // Add View styles and constants to the Combo Box ComboBox1->Items->AddObject("vsIcon", (TObject *)vsIcon); ComboBox1->Items->AddObject("vsList", (TObject *)vsList); ComboBox1->Items->AddObject("vsReport", (TObject *)vsReport); ComboBox1->Items->AddObject("vsSmallIcon", (TObject *)vsSmallIcon); // Display first item in the Combo Box ComboBox1->ItemIndex = 0; } void __fastcall TForm1::ComboBox1Click(TObject *Sender) { ListView1->ViewStyle = (TViewStyle) ComboBox1->Items->Objects[ComboBox1->ItemIndex]; }
Delphi Examples:
{ This example requires a TListView, a TImageList and a TComboBox. You will need to double click the image list and add several images to the image list prior to running the project. You can use *.bmp or *.ico files from the \Images\Icons directory. During the form’s OnCreate event handler, items for the List View control are created for each image in the Image List and the ImageIndex is assigned the number of the image within the ImageList. Two columns are created so that when ViewStyle is vsReport, you will have columns to view. Also within the form’s OnCreate event handler assign the ComboBox each of the four TViewStyle constants to the Items’ Objects property. You could also simply code this within a series of OnClick event handlers as, for instance, ListView1.->ViewStyle := vsIcon. } procedure TComboForm.FormCreate(Sender: TObject); var I: Integer; ListItem: TListItem; NewColumn: TListColumn; begin Col2Array[0]:= 'Documentation for Image0.'; Col2Array[1]:= 'Documentation for Image1.'; Col2Array[2]:= 'Documentation for Image2.'; // Create a ListView item for each image in the ImageList with ListView1 do begin SmallImages := ImageList1; LargeImages := ImageList1; for I := 0 to ImageList1.Count - 1 do begin ListItem := Items.Add; Listitem.Caption := 'Image' + IntToStr(I); ListItem.ImageIndex := I; Listitem.SubItems.Add(Col2Array[I]); end; // Create two columns to show during viewing as vsReport NewColumn := Columns.Add; NewColumn.Caption := 'Column 1'; NewColumn.Width := 200; NewColumn := Columns.Add; NewColumn.Caption := 'Column 2'; NewColumn.Width := 200; // Add View styles and constants to the Combo Box ComboBox1.Items.AddObject('vsIcon', TObject(vsIcon)); ComboBox1.Items.AddObject('vsList', TObject(vsList)); ComboBox1.Items.AddObject('vsReport', TObject(vsReport)); ComboBox1.Items.AddObject( 'vsSmallIcon', TObject(vsSmallIcon)); // Display first item in the Combo Box ComboBox1.ItemIndex := 0; end; end; procedure TComboForm.ComboBox1Click(Sender: TObject); begin with ComboBox1 do ListView1.ViewStyle := TViewStyle(Items.Objects[ItemIndex]); end;
Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
|
What do you think about this topic? Send feedback!
|