How to: Enable Automatic Height Adjustment

Dec 15, 2018
2 minutes to read
Automatic Node Height Adjustment
Disable Automatic Node Height Adjustment
Specify Custom Height
Automatic Node Height and Image Data
Automatic Node Height and Text Data
Specify Custom Image Height

Automatic Node Height Adjustment

The Tree list node height is set to match content height.

Disable Automatic Adjustment

To disable automatic height adjustment, set the TreeList.OptionsBehavior.AutoNodeHeight (see TreeListOptionsBehavior.AutoNodeHeight) property to False.

In this mode, node height corresponds to the height of a single text line. Images are scaled to fit automatically calculated height.

Specify Custom Node Height

To specify custom node height, disable automatic height adjustment, and specify the height using the TreeList.RowHeight property.

Once the custom node height has been set, text fields are properly centered, and images are scaled.

To customize node height, you can also handle the TreeList.CalcNodeHeight event, and specify the CalcNodeHeightEventArgs.NodeHeight event argument.

Automatic Node Height and Image Data

When automatic height adjustment is turned on, images are displayed using their original dimensions as specified in the database. If you delete an image, node height will be automatically adjusted.

Automatic Node Height and Text Data

To enable automatic height adjustment for cells with text data, select the column and use the TreeListColumn.ColumnEdit property to assign a new MemoEdit editor.

Ensure that the RepositoryItemMemoEdit.WordWrap property is set to true and then run the application. The Tree List adjusts the node height, so that the text is completely visible. If you add or remove the text, the height will be updated.

Specify Custom Image Height

To specify custom height for images, assign a PictureEdit to the column. Use the editor’s RepositoryItemPictureEdit.CustomHeight property to specify the required value.

If you run the application, you will see that images are now truncated. The editor allows you to see the entire image by dragging it.

To shrink the images so that they fit the specified cell height, set RepositoryItemPictureEdit.SizeMode to PictureSizeMode.Zoom. Note that in this mode, the node keeps its height if you remove the image.