asp.net.ph

Skip Navigation Links

Customizing the BulletedList Control Interface

Controls You Can Use on Web Forms   ASP.NET Standard Controls   BulletedList Control


The BulletedList control exposes several properties to specify the visual rendering of the bulletedlist items in the control. The following table lists the available bulletedlist item styles you can specify for the BulletedList.

BulletedList item style property Description
DynamicHoverStyle The style settings for a dynamic bulletedlist item when the mouse pointer is positioned over it.
DynamicBulletedListItemStyle The style settings for an individual dynamic bulletedlist item.
DynamicBulletedListStyle The style settings for a dynamic bulletedlist.
DynamicSelectedStyle The style settings for the currently selected dynamic bulletedlist item.
StaticHoverStyle The style settings for a static bulletedlist item when the mouse pointer is positioned over it.
StaticBulletedListItemStyle The style settings for an individual static bulletedlist item.
StaticBulletedListStyle The style settings for a static bulletedlist.
StaticSelectedStyle The style settings for the currently selected static bulletedlist item.

Instead of setting the individual style properties, you can specify styles that are applied to bulletedlist items based on their level by using the following style collections.

Level style collections Description
LevelBulletedListItemStyles A collection of BulletedListItemStyle objects that control the style of the bulletedlist items on a level basis.
LevelSelectedStyles A collection of BulletedListItemStyle objects that control the style of selected bulletedlist items on a level basis.
LevelSubBulletedListStyles A collection of BulletedListItemStyle objects that control the style of the subbulletedlist items on a level basis.

The first style in the collection corresponds to the style of the bulletedlist items at the first depth level in the bulletedlist tree. The second style in the collection corresponds to the style of the bulletedlist items at the second depth level in the bulletedlist tree, and so on. This is most often used to generate table of contents-style navigation bulletedlists where bulletedlist items at a certain depth should have the same appearance, regardless of whether they have subbulletedlists.

NOTE: If you use any of the level style collections listed in the previous table to define the style for the BulletedList control, these style settings override the individual bulletedlist item style properties.

Another way to alter the appearance of the control is to customize the images displayed in the BulletedList control. You can specify your own custom image for the different parts of the control by setting the properties shown in the following table.

Image property Description
DynamicBottomSeparatorImageUrl An optional image displayed at the bottom of a dynamic bulletedlist item to separate it from other bulletedlist items.
DynamicPopOutImageUrl An optional image displayed in a dynamic bulletedlist item to indicate that it has a subbulletedlist.
DynamicTopSeparatorImageUrl An optional image displayed at the top of a dynamic bulletedlist item to separate it from other bulletedlist items.
ScrollDownImageUrl The image displayed at the bottom of a bulletedlist item to indicate that the user can scroll down to view additional bulletedlist items.
ScrollUpImageUrl The image displayed at the top of a bulletedlist item to indicate that the user can scroll up to view additional bulletedlist items.
StaticBottomSeparatorImageUrl An optional image displayed at the bottom of a static bulletedlist item to separate it from other bulletedlist items.
StaticPopOutImageUrl An optional image displayed in a static bulletedlist item to indicate that it has a subbulletedlist.
StaticTopSeparatorImageUrl An optional image displayed at the top of a static bulletedlist item to separate it from other bulletedlist items.

Templates for Control Layout

The BulletedList control supports additional customization through templates, which offer more control over the rendering of certain elements. The following table lists the template types you can specify for the BulletedList.

Template property Description
DynamicItemTemplate The template that contains the custom content to render for a dynamic bulletedlist item.
StaticItemTemplate The template that contains the custom content to render for a static bulletedlist item.

You can control the vertical and horizontal position of a dynamic bulletedlist relative to its parent bulletedlist item by setting the DynamicVerticalOffset and DynamicHorizontalOffset properties, respectively. To control the indentation of the static subbulletedlist items within a static bulletedlist, use the StaticSubBulletedListIndent property.

See Also

Responding to BulletedList Item Events   Web Forms Server Controls and CSS Styles



© 2025 Reynald Nuñez and asp.net.ph. All rights reserved.

If you have any question, comment or suggestion
about this site, please send us a note