Click here to Skip to main content
Click here to Skip to main content

ListView Watermark in VB.NET

, 26 Oct 2013 CPOL
Rate this:
Please Sign up or sign in to vote.
Code to add a watermark to a ListView using the LVBKIF_TYPE_WATERMARK flag

Vista Themeing Enabled
Vista Themeing Disabled
Windows Vista/Windows 7 Screenshot

Update

  • Added the code suggested by rojaldearintok
  • Also, no longer ignores item background color. However, the item's background color will appear transparent, so that the watermark will still show through.
  • Added a property called UseVistaThemeing

Changes as of September 02, 2013

  • Added property called ShowFocusRectangle - Haven't figured out how to Show/Hide the focus-rect during run-time. Must be set at design-time.

  • Bug Fixed: Horizontal Scrolling leaving a white space. No longer does this. Problem lay in the ItemDraw Event where I was setting the draw area to the ClientRectangle.Width. Now checks to see if the Item's Rectangle.Width is larger or less than the ClientRectangle.Width.

Changes as of October 26, 2013

  • Added property UseLedgerStyle, LedgerStyleDarkColor, LedgerStyleLightColor, ColumnSortIndex, ColumnSortOrder, ColumnSortStyle.

    1. UseLedgerStyle: Set to true to show a list of items with alternating colors per row
    2. LedgerStyleDarkColor: Color of an even numbered index
    3. LedgerStyleLightColor: Color of an odd numbered index
    4. ColumnSortIndex: Index of the Column to sort by
    5. ColumnSortOrder: Indicates how to sort the items. Ascending/Descending
    6. ColumnSortStyle: What to sort by (Image, Text, or Checkbox)
  • Added SubItemClick, and SubItemDoubleClick Events:
    1. SubItemClick: Fires when a subitem is clicked. EventArgs has property that indicates the subitem that was clicked along with its owner Item.
    2. SubItemDoubleClick: Fires when a subitem is Doubleclicked. EventArgs has property that indicates the subitem that was clicked along with its owner Item.
  • Changed project name to ProjectListview, since this has become a collaboration of code.

Changes as of January 2, 2014

  • Fixed bug with ledgerstyledarkcolor being present at runtime when switching ledgerstyle on/off after setting the watermark image. (I've had this update done for a while, but got really busy with work and hadn't had the time to upload it.

Changes as of December 20, 2014

  • No longer causes generic GDI+ error
  • Notice 2: You will see 2 cListView classes in the solution included in the zip file. I am working on moving the control to a separate library for full customization of the listview. I plan on adding custom column types such as boolean, button, etc.
  • Item backcolors work properly. You can now switch to and from Ledger style without the colors being messed up. Example: If you add an item with a red background and you happen to default to Ledger Style, the list will be drawn with the Ledger colors. If UseLedger is False, then the item will be drawn with a red background.

Future Plans

Special Column Types: checkbox, progressbar, etc. ColumnHeader themeing. FixedColumnWidth.

Introduction

This code uses the LVBKIF_TYPE_WATERMARK flag of LVBKIMAGE to put a watermark in the lower right corner of a ListView control.

Using the Code

The zip file above includes a class that inherits the ListView. Add the class to your solution, and build the solution. In the control's toolbox, you'll see the cListView added. Drag one onto the form and set its WatermarkImage property to the desired image you want. Also, set the WatermarkAlpha property to the desired translucency. It will support any image file that VB.NET can open. It will automatically convert the image to the needed bitmap.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

clwprogrammer

United States United States
Self Taught Programmer. Programming is one of many Hobbies that I enjoy doing. Started learning back in 2001 when I discovered how the template wizards worked for Microsoft Office. Have learned lots, and am still learning.
Follow on   Google+

Comments and Discussions

 
General[My vote of 2] good find PinmemberDonsw12-Sep-09 17:24 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150123.1 | Last Updated 27 Oct 2013
Article Copyright 2009 by clwprogrammer
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid