Leadtools.WinForms Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
AutoDeselectItems Property
See Also  Example
Leadtools.WinForms Namespace > RasterImageList Class : AutoDeselectItems Property



Enables or disables de-selecting items when mouse button is clicked.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Behavior")>
<DescriptionAttribute("Enables or disables de-selecting items when mouse button is clicked when selection mode is set to multi.")>
Public Property AutoDeselectItems As Boolean
Visual Basic (Usage)Copy Code
Dim instance As RasterImageList
Dim value As Boolean
 
instance.AutoDeselectItems = value
 
value = instance.AutoDeselectItems
C# 
[CategoryAttribute("Behavior")]
[DescriptionAttribute("Enables or disables de-selecting items when mouse button is clicked when selection mode is set to multi.")]
public bool AutoDeselectItems {get; set;}
C++/CLI 
[CategoryAttribute("Behavior")]
[DescriptionAttribute("Enables or disables de-selecting items when mouse button is clicked when selection mode is set to multi.")]
public:
property bool AutoDeselectItems {
   bool get();
   void set (bool value);
}

Return Value

true to enable de-selecting; false otherwise.

Example

This example shows how to select (rubber band) and deselect multiple items with a mouse button. Run the sample, and select two or more items. Then click the mouse button to deselect all items.

Visual BasicCopy Code
Private Class MyForm6 : Inherits Form
    Public imageList As RasterImageList
    Private codecs As RasterCodecs
    Public Sub New()
        ' Set the size of the form
        Size = New Size(500, 200)

        ' Create a new RasterImageList control
        imageList = New RasterImageList()
        imageList.Dock = DockStyle.Fill
        imageList.SelectionMode = RasterImageListSelectionMode.Single
        imageList.Size = Size
        Controls.Add(imageList)
        imageList.BringToFront()

        RasterCodecs.Startup()
        codecs = New RasterCodecs()

        ' Create three items
        Dim imagesPath As String = LeadtoolsExamples.Common.ImagesPath.Path

        For i As Integer = 0 To 2
            ' Load the image
            Dim index As Integer = i + 1
            Dim imageFileName As String = imagesPath & "Image" & index.ToString() & ".cmp"
            Dim image As RasterImage = codecs.Load(imageFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1)
            Dim item As RasterImageListItem = New RasterImageListItem(image, 1, "Item" & index.ToString())

            ' Select the first item
            If i = 0 Then
                item.Selected = True
            End If

            ' Add the item to the image list
            imageList.Items.Add(item)
        Next i

        RasterCodecs.Shutdown()

        ' Add the RasterImageList to the control collection.
        Controls.Add(imageList)
    End Sub
End Class

Public Sub RasterImageList_AutoDeselectItems()
    Dim form As MyForm6 = New MyForm6()

    ' Enable rubber band multi select
    form.imageList.EnableRubberBandSelection = True

    ' Enable the AutoDeselectItems
    form.imageList.AutoDeselectItems = True
    form.imageList.SelectionMode = RasterImageListSelectionMode.Multi

    form.Text = "Drag mouse to select two images. Then single-click to de-select."

    form.ShowDialog()
End Sub
C#Copy Code
class MyForm6 : Form 
{ 
   public RasterImageList imageList; 
   RasterCodecs codecs; 
   public MyForm6() 
   { 
      // Set the size of the form 
      Size = new Size(500, 200); 
 
      // Create a new RasterImageList control 
      imageList = new RasterImageList(); 
      imageList.Dock = DockStyle.Fill; 
      imageList.SelectionMode = RasterImageListSelectionMode.Single; 
      imageList.Size = Size; 
      Controls.Add(imageList); 
      imageList.BringToFront(); 
 
      RasterCodecs.Startup(); 
      codecs = new RasterCodecs(); 
 
      // Create three items 
      string imagesPath = LeadtoolsExamples.Common.ImagesPath.Path; 
 
      for(int i = 0; i < 3; i++) 
      { 
         // Load the image 
         int index = i + 1; 
         string imageFileName = imagesPath + "Image" + index.ToString() + ".cmp"; 
         RasterImage image = codecs.Load(imageFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1); 
         RasterImageListItem item = new RasterImageListItem(image, 1, "Item" + index.ToString()); 
 
         // Select the first item 
         if(i == 0) 
            item.Selected = true; 
 
         // Add the item to the image list 
         imageList.Items.Add(item); 
      } 
 
      RasterCodecs.Shutdown(); 
 
      // Add the RasterImageList to the control collection. 
      Controls.Add(imageList); 
   } 
} 
 
public void RasterImageList_AutoDeselectItems() 
{ 
   MyForm6 form = new MyForm6(); 
 
   // Enable rubber band multi select 
   form.imageList.EnableRubberBandSelection = true; 
 
   // Enable the AutoDeselectItems 
   form.imageList.AutoDeselectItems = true; 
   form.imageList.SelectionMode = RasterImageListSelectionMode.Multi; 
 
   form.Text = "Drag mouse to select two images.  Then single-click to de-select."; 
 
   form.ShowDialog(); 
}

Remarks

This property is used only if SelectionMode is set to RasterImageListSelectionMode.Multi.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also