text – Owl's Blog on .NET development http://www.componentowl.com/blog Component Owl codes Better ListView control all night so you don't have to. Tue, 04 Sep 2018 13:10:05 +0000 en-US hourly 1 https://wordpress.org/?v=4.9.8 Displaying Multi-Line Text In ListView http://www.componentowl.com/blog/displayingmultiline-items-in-listview/ http://www.componentowl.com/blog/displayingmultiline-items-in-listview/#respond Thu, 24 Nov 2011 16:42:44 +0000 http://www.componentowl.com/blog/?p=450 Multi-Line text has been supported since Better ListView 2.0 (as automatic text-wrapping with configurable number of Maximum Text Lines), but we enhanced this feature inversion 2.3.2 by adding support for “hardcoded” newline characters (LF) in item text:

Items with multi-line text

Items with multi-line text

Column headers and even groups can contain multi-line text:

Multi-line text in groups

Multi-line text in groups

So the text can be split on multiple lines not only by wrapping the text, but also by user defined newline characters.

This feature comes out of the box.

The only setting associated with multi-line items is the MaximumTextLines property of the corresponding layout (e.g. BetterListView.LayoutItemsLargeIcon). This property specifies how many lines the text can have and this applies to both wrapped text and text with newline characters. So if you expect you text to have 5 to 20 lines, set the MaximumTextLines property to 20 and you know the items will not get too high while still displaying all the lines.

Multi-line text is supported on column headers, items, sub-items and groups.

Download the latest Better ListView

]]> http://www.componentowl.com/blog/displayingmultiline-items-in-listview/feed/ 0 Vertical Alignment and Text Wrapping in Better ListView http://www.componentowl.com/blog/vertical-alignment-and-text-wrapping-in-better-listview/ http://www.componentowl.com/blog/vertical-alignment-and-text-wrapping-in-better-listview/#comments Wed, 16 Nov 2011 23:57:39 +0000 http://www.componentowl.com/blog/?p=437 .NET ListView supports horizontal alignment of text in columns, items, sub-items and groups. Since Better ListView adds many new features, like multi-line items and images of arbitrary size, vertical alignment comes in handy.

By default, each view has its defaults, but you can customize text alignment on every column, item, sub-item and group individually:

Vertical alignments of text

Vertical alignments of text

The vertical alignment feature is a new property of each element type. For example, .NET ListView item has a property called Align which refers to horizontal alignment. Better ListView extends this to two independent properties called AlignHorizontal and AlignVertical. The naming scheme is same for columns, items, sub-items and groups.

Better ListView also supports splitting text in column headers and items (sub-items) into multiple lines.

We extended this functionality by adding a BetterListViewItem.TextWrapping and BetterListViewSubItem.TextWrapping properties. With these, you can control how the text in sub-items will be wrapped. There are three possible values:

  • Layout – the text will be wrapped to multiple lines, up to value specified by MaximumTextLines property of the corresponding view (layout)
  • None – the text will not be wrapped at all
  • Space – the text will be wrapped, but only to available space (item will never get higher due to wrapping text in sub-item with this setting)
The following screenshot shows these three wrapping modes in action:
Various text wrapping modes

Various text wrapping modes

The sub-item in the first column has TextWrapping set to Layout and the layout has MaximumTextLines set to 4. The sub-item text thus can be split to up to four lines. It is actually split just to three because the column is wide enough.

The sub-item in the second column has TextWrapping set to None, which means the text in this sub-item is kept on single line.

The sub-item in the third column has TextWrapping set to Space. As you can see, even if the MaximumTextLines is set to 4, the sub-item text is limited to three lines, preventing item to grow larger.

]]> http://www.componentowl.com/blog/vertical-alignment-and-text-wrapping-in-better-listview/feed/ 1