Infragistics2.Win.UltraWinListView.v8.1
AutoSizeMode Property
See Also  Example
Infragistics.Win.UltraWinListView Namespace > UltraListViewColumnBase Class : AutoSizeMode Property

Gets/sets whether the width of this column is automatically made large enough to display the header text and/or all item/sub-item values when the end user double-clicks on the header.

Syntax

Visual Basic (Declaration) 
Public Property AutoSizeMode As ColumnAutoSizeMode
C# 
public ColumnAutoSizeMode AutoSizeMode {get; set;}

Remarks

Note: The AutoSizeMode property is only applicable when the UltraListView.View property is set to 'Details'.

Note: If the value of the UltraListViewColumnBase.AllowSizing property resolves to false, and sizing via the user interface for this column is disallowed, the AutoSizeMode property resolves to 'None', and the column cannot be auto-sized via the user interface.

The AutoSizeMode property affects only the column on which the property is set; to set the auto-sizing mode for all columns displayed by the control, use the UltraListViewDetailsSettings.ColumnAutoSizeMode property.

Example

The following code sample demonstrates how to use the ColumnAutoSizeMode property of the UltraListViewDetailsSettings class, and the AutoSizeMode property of the UltraListViewColumnBase class, to enable the end user to easily resize the MainColumn's width to the size required to fully display both item and header text:

Visual BasicCopy Code
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinListView

        ' Set the AutoSizeMode property of the MainColumn to 'VisibleItemsAndHeader',
        ' so that when the end user double-clicks the right edge of the header, the
        ' width of the column is adjusted so as to fully display the text of all
        ' visible items, as well as the header's caption.
        Me.ultraListView1.MainColumn.AutoSizeMode = ColumnAutoSizeMode.VisibleItemsAndHeader

        ' Call the PerformAutoResize method to programmatically resize the column
        Me.ultraListView1.MainColumn.PerformAutoResize(Me.ultraListView1.MainColumn.AutoSizeMode)

        ' Set the ColumnAutoSizeMode property of the UltraListViewDetailsSettings
        ' object (returned by the control's ViewSettingsDetails property) to a combination
        ' of the 'Header' and either 'VisibleItems' or 'AllItems' bits, depending on whether
        ' there are a relatively large number of items being displayed.
        Dim autoSizeMode As ColumnAutoSizeMode = ColumnAutoSizeMode.Header
        If (Me.ultraListView1.Items.Count >= LARGE_ITEM_COUNT) Then
            autoSizeMode = autoSizeMode Or ColumnAutoSizeMode.VisibleItems
        Else
            autoSizeMode = autoSizeMode Or ColumnAutoSizeMode.AllItems
        End If

        Me.ultraListView1.ViewSettingsDetails.ColumnAutoSizeMode = autoSizeMode
C#Copy Code
using Infragistics.Win;
using Infragistics.Win.UltraWinListView;

   //  Set the AutoSizeMode property of the MainColumn to 'VisibleItemsAndHeader',
   //  so that when the end user double-clicks the right edge of the header, the
   //  width of the column is adjusted so as to fully display the text of all
   //  visible items, as well as the header's caption.
   this.ultraListView1.MainColumn.AutoSizeMode = ColumnAutoSizeMode.VisibleItemsAndHeader;

   //  Call the PerformAutoResize method to programmatically resize the column
   this.ultraListView1.MainColumn.PerformAutoResize(this.ultraListView1.MainColumn.AutoSizeMode);

   //  Set the ColumnAutoSizeMode property of the UltraListViewDetailsSettings
   //  object (returned by the control's ViewSettingsDetails property) to a combination
   //  of the 'Header' and either 'VisibleItems' or 'AllItems' bits, depending on whether
   //  there are a relatively large number of items being displayed.
   ColumnAutoSizeMode autoSizeMode = ColumnAutoSizeMode.Header;
   if ( this.ultraListView1.Items.Count >= LARGE_ITEM_COUNT )
       autoSizeMode |= ColumnAutoSizeMode.VisibleItems;
   else
       autoSizeMode |= ColumnAutoSizeMode.AllItems;

   this.ultraListView1.ViewSettingsDetails.ColumnAutoSizeMode = autoSizeMode;

    

See Also