Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

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
'Declaration
 
Public Property AutoSizeMode As ColumnAutoSizeMode
public ColumnAutoSizeMode AutoSizeMode {get; set;}
Remarks

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

Note: If the value of the 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 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:

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
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;
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also