ComponentOne List for WinForms
In This Topic
    Multiple Line Data Display
    In This Topic

    Normally, a record is displayed in a single row in the list. If the list is not wide enough to display all of the columns in the record, a horizontal scroll bar automatically appears to enable users to scroll columns in and out of view. For discussion purposes, we shall distinguish between the following:

    Setting the DataView property of the list to MultipleLines will display every field of data in the dataset in the available list area. Ultimately, if your dataset contains more fields than can fit in the list area, then a single record will span multiple lines. This feature enables the end user to view simultaneously all of the columns (fields) of a record within the width of the list without scrolling horizontally, as in the following figure:

    If the resulting column layout is not to your liking, you can adjust it either in the designer or in code by changing the widths and orders of the columns. When changing the width of a column, the list will only increase the size of the column at the expense of the other columns in the line. Unlike previous versions of the list, the columns won't wrap to another line if a column is resized.

    To change the order of the columns while in Multiple Line view, click and drag the column header to the new position. A red arrow should indicate where you are about to place the column. After you have dropped the column, the list will reposition the columns accordingly.

    Note: At design time, if the HScrollBar and VScrollBar style property is set to Automatic, and the DataView property is set to MultipleLines, a vertical scroll bar appears even though no data is displayed. This is done so that you can take the width of the scroll bar into account when adjusting columns at design time.
    See Also