Syncfusion.Shared.Base
Members 


GroupView Class

Represents the partial class of the GroupView which contains the theme renderer properties and methods. Represents a control that can display a list of items.
Object Model
GroupView ClassGroupView.GroupViewItemCollection ClassGroupViewItem ClassGroupViewItemAccessibleObjectsIndexer ClassGroupViewVisualStyle Class
Syntax
'Declaration
 
<ToolboxBitmapAttribute(Syncfusion.Windows.Forms.PopupControlContainer, "ToolboxIcons.groupviewcontrol.bmp")>
<DefaultEventAttribute("GroupViewItemSelected")>
<DefaultPropertyAttribute("GroupViewItems")>
<DescriptionAttribute("Represents a list type control that can display a list of items.")>
<ToolboxItemAttribute(True)>
<DesignerAttribute(Syncfusion.Windows.Forms.Tools.Design.GroupViewDesigner, System.ComponentModel.Design.IDesigner)>
<DesignerSerializerAttribute("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>
<ToolboxItemFilterAttribute("System.Windows.Forms")>
<DesignerCategoryAttribute("Component")>
Public Class GroupView 
   Inherits Syncfusion.Windows.Forms.Core.BaseControl
   Implements Syncfusion.Windows.Forms.IVisualStyle, IGroupViewDesignerInvoke, IIntegratedScrollClient, Syncfusion.WinForms.Theme.IThemeProvider 
'Usage
 
Dim instance As GroupView
[ToolboxBitmap(Syncfusion.Windows.Forms.PopupControlContainer, "ToolboxIcons.groupviewcontrol.bmp")]
[DefaultEvent("GroupViewItemSelected")]
[DefaultProperty("GroupViewItems")]
[Description("Represents a list type control that can display a list of items.")]
[ToolboxItem(true)]
[Designer(Syncfusion.Windows.Forms.Tools.Design.GroupViewDesigner, System.ComponentModel.Design.IDesigner)]
[DesignerSerializer("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ToolboxItemFilter("System.Windows.Forms")]
[DesignerCategory("Component")]
public class GroupView : Syncfusion.Windows.Forms.Core.BaseControl, Syncfusion.Windows.Forms.IVisualStyle, IGroupViewDesignerInvoke, IIntegratedScrollClient, Syncfusion.WinForms.Theme.IThemeProvider  
Remarks

The GroupView control implements a list type control that can display a set of items where each item is represented by an image and a descriptor. Items are implemented as instances of the GroupViewItem class. The collection of GroupViewItems in the control can be accessed through the GroupViewItems property that returns a reference to the GroupView.GroupViewItemCollection object maintained by the control.

The GroupView control is capable of displaying items with large or small icons in various combinable styles such as the default selectable style, button-type selection, full-item select and an icon-only flowview mode. All styles are available in the regular 3D or a FlatLook mode. The control also implements an IntegratedScrolling option that allows scrolling to be delegated to its parent container.

The GroupView control can be used in conjunction with the Essential Tools GroupBar control to implement composite controls such as the Microsoft OutlookBar and the Visual Studio.NET toolbox window. The latter scenario makes use of the IntegratedScrolling feature supported by the two controls.

Example
The sample code shows how to create a GroupView control and initialize the Behavior and Appearance properties to resemble the Visual Studio.NET toolbox window. A handler for the GroupView.GroupViewItemSelected event is also shown. private void InitializeGroupView() { // Create the GroupView control. this.gvcWinForms = new Syncfusion.Windows.Forms.Tools.GroupView(); // Set the large and small ImageLists. this.gvcWinForms.LargeImageList = this.ilGroupBarLarge; this.gvcWinForms.SmallImageList = this.ilGroupBarSmall; // Set the GroupView properties to display as a VS.NET tool box type window. this.gvcWinForms.SmallImageView = true; this.gvcWinForms.HighlightText = true; this.gvcWinForms.ButtonView = true; this.gvcWinForms.FlowView = false; this.gvcWinForms.FlatLook = false; this.gvcWinForms.TextWrap = false; this.gvcWinForms.ImageSpacing = 2; this.gvcWinForms.ItemXSpacing = 8; this.gvcWinForms.ItemYSpacing = 1; this.gvcWinForms.BackColor = SystemColors.Control; this.gvcWinForms.ForeColor = SystemColors.ControlText; this.gvcWinForms.HighlightItemColor = SystemColors.Control; this.gvcWinForms.SelectingItemColor = ControlPaint.Light(SystemColors.ControlLight); this.gvcWinForms.SelectedItemColor = ControlPaint.Light(SystemColors.ControlLight); this.gvcWinForms.SelectedHighlightItemColor = SystemColors.Control; this.gvcWinForms.SelectingTextColor = SystemColors.ControlText; this.gvcWinForms.SelectedHighlightTextColor = SystemColors.ControlText; // Create and add the GroupViewItem objects. this.gvcWinForms.GroupViewItems.AddRange( new Syncfusion.Windows.Forms.Tools.GroupViewItem[] { new Syncfusion.Windows.Forms.Tools.GroupViewItem("Pointer", 11), new Syncfusion.Windows.Forms.Tools.GroupViewItem("Label", 12), new Syncfusion.Windows.Forms.Tools.GroupViewItem("LinkLabel", 13)}); // Provide a handler for the GroupView.GroupViewItemSelected event. this.gvcWinForms.GroupViewItemSelected += new System.EventHandler(this.gvcWinForms_GroupViewItemSelected); } // GroupView.GroupViewItemSelected event handler. private void gvcWinForms_GroupViewItemSelected(object sender, System.EventArgs e) { MessageBox.Show(String.Concat("Selected Item Index = ", this.gvcWinForms.SelectedItem.ToString())); } Private Sub InitializeGroupView() ' Create the GroupView control Me.gvcWinForms = New Syncfusion.Windows.Forms.Tools.GroupView() ' Set the large and small ImageLists Me.gvcWinForms.LargeImageList = Me.ilGroupBarLarge Me.gvcWinForms.SmallImageList = Me.ilGroupBarSmall ' Set the GroupView properties to display as a VS.NET Toolbox type window Me.gvcWinForms.SmallImageView = True Me.gvcWinForms.HighlightText = True Me.gvcWinForms.ButtonView = True Me.gvcWinForms.FlowView = False Me.gvcWinForms.FlatLook = False Me.gvcWinForms.TextWrap = False Me.gvcWinForms.ImageSpacing = 2 Me.gvcWinForms.ItemXSpacing = 8 Me.gvcWinForms.ItemYSpacing = 1 Me.gvcWinForms.BackColor = SystemColors.Control Me.gvcWinForms.ForeColor = SystemColors.ControlText Me.gvcWinForms.HighlightItemColor = SystemColors.Control Me.gvcWinForms.SelectingItemColor = ControlPaint.Light(SystemColors.ControlLight) Me.gvcWinForms.SelectedItemColor = ControlPaint.Light(SystemColors.ControlLight) Me.gvcWinForms.SelectedHighlightItemColor = SystemColors.Control Me.gvcWinForms.SelectingTextColor = SystemColors.ControlText Me.gvcWinForms.SelectedHighlightTextColor = SystemColors.ControlText ' Create and add the GroupViewItem objects. Me.gvcWinForms.GroupViewItems.AddRange(New Syncfusion.Windows.Forms.Tools.GroupViewItem() {New Syncfusion.Windows.Forms.Tools.GroupViewItem("Pointer", 11), New Syncfusion.Windows.Forms.Tools.GroupViewItem("Label", 12), New Syncfusion.Windows.Forms.Tools.GroupViewItem("LinkLabel", 13)}) ' Handle the GroupView.GroupViewItemSelected event. AddHandler Me.gvcWinForms.GroupViewItemSelected, New System.EventHandler(AddressOf gvcWinForms_GroupViewItemSelected) End Sub ' GroupView.GroupViewItemSelected event handler. Private Sub gvcWinForms_GroupViewItemSelected(ByVal sender As Object, ByVal e As System.EventArgs) MessageBox.Show([String].Concat("Selected Item Index = ", Me.gvcWinForms.SelectedItem.ToString())) End Sub 'gvcWinForms_GroupViewItemSelected
Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            Syncfusion.Windows.Forms.Core.BaseControl
               Syncfusion.Windows.Forms.Tools.GroupView
                  Syncfusion.Windows.Forms.Diagram.Controls.PaletteGroupView

AssemblyVersion

Syncfusion.Shared.Base: 17.3460.0.26

See Also