BulletStyle BulletStyle BulletStyle BulletStyle Enum

Определение

Задает стиль маркеров, который можно применить к элементам списка в элементе управления BulletedList.Specifies the bullet styles you can apply to list items in a BulletedList control.

public enum class BulletStyle
public enum BulletStyle
type BulletStyle = 
Public Enum BulletStyle
Наследование

Поля

Circle Circle Circle Circle 7

Стилем маркеров становится окружность.The bullet style is an empty circle shape.

CustomImage CustomImage CustomImage CustomImage 9

Стилем маркеров становится пользовательское изображение.The bullet style is a custom image.

Disc Disc Disc Disc 6

Стилем маркеров становится заполненный кружок.The bullet style is a filled circle shape.

LowerAlpha LowerAlpha LowerAlpha LowerAlpha 2

Стилем маркеров становятся буквы в нижнем регистре (а, б, в, ...).The bullet style is a lowercase letter (a, b, c, ...).

LowerRoman LowerRoman LowerRoman LowerRoman 4

Стилем маркеров становятся римские цифры в нижнем регистре (i, ii, iii, ...).The bullet style is a lowercase Roman numeral (i, ii, iii, ...).

NotSet NotSet NotSet NotSet 0

Стиль маркеров не указан.The bullet style is not set. Стиль маркеров определяется браузером, отображающим элемент управления BulletedList.The browser that renders the BulletedList control will determine the bullet style to display.

Numbered Numbered Numbered Numbered 1

Стилем маркеров становится число (1, 2, 3, ...).The bullet style is a number (1, 2, 3, ...).

Square Square Square Square 8

Стилем маркеров становится заполненный квадрат.The bullet style is a filled square shape.

UpperAlpha UpperAlpha UpperAlpha UpperAlpha 3

Стилем маркеров становятся буквы в верхнем регистре (А, Б, В, ...).The bullet style is an uppercase letter (A, B, C, ...).

UpperRoman UpperRoman UpperRoman UpperRoman 5

Стилем маркеров становятся римские цифры в верхнем регистре (I, II, III, ...).The bullet style is an uppercase Roman numeral (I, II, III, ...).

Примеры

Следующий пример демонстрирует создание BulletedList элемента управления.The following example demonstrates how to create a BulletedList control. Объект ListBox заполнения элемента управления со всеми доступными BulletStyle значений перечисления.A ListBox control is populated with all available BulletStyle enumeration values. Стиль маркера изменяется в зависимости от стиль, пользователю предлагается выбрать из списка.The bullet style changes based on the style that the user selects from the list box.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
            BulletStyle Example</title>
<script runat="server">       
        protected void Index_Changed(object sender, EventArgs e)
        {
            // Change the message displayed, based on 
            // the style selected from the list box.
            if (BulletStylesListBox.SelectedIndex > -1)
            {
                Message.Text = "You selected bullet style: " +
                    BulletStylesListBox.SelectedItem.Text;
            }

            // Change the bullet style used, based on 
            // the style selected from the list box.
            switch (BulletStylesListBox.SelectedIndex)
            {
                case 0:
                    ItemsBulletedList.BulletStyle = BulletStyle.Numbered;
                    break;
                case 1:
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerAlpha;
                    break;
                case 2:
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperAlpha;
                    break;
                case 3:
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerRoman;
                    break;
                case 4:
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperRoman;
                    break;
                case 5:
                    ItemsBulletedList.BulletStyle = BulletStyle.Disc;
                    break;
                case 6:
                    ItemsBulletedList.BulletStyle = BulletStyle.Circle;
                    break;
                case 7:
                    ItemsBulletedList.BulletStyle = BulletStyle.Square;
                    break;
                case 8:
                    ItemsBulletedList.BulletStyle = BulletStyle.CustomImage;
                    // Specify the path to the custom image to use for the bullet.
                    ItemsBulletedList.BulletImageUrl = "Images/image1.jpg";
                    break;
                case 9:
                    Message.Text = "You selected NotSet. The browser will determine the bullet style.";
                    break;
                default:
                    throw new Exception("You did not select a valid bullet style.");
            }

        }
</script>

</head>
<body>
    <form id="form1" runat="server">
        <h3>
            BulletStyle Example</h3>
        <asp:BulletedList ID="ItemsBulletedList" DisplayMode="Text" BulletStyle="NotSet"
            runat="server">
            <asp:ListItem Value="0">Coho Winery</asp:ListItem>
            <asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
            <asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
        </asp:BulletedList>
        <hr />
        <h4>
            Select a bullet type:</h4>
        <asp:ListBox ID="BulletStylesListBox" SelectionMode="Single" Rows="1" OnSelectedIndexChanged="Index_Changed"
            AutoPostBack="True" runat="server">
            <asp:ListItem Value="Numbered">Numbered</asp:ListItem>
            <asp:ListItem Value="LowerAlpha">LowerAlpha</asp:ListItem>
            <asp:ListItem Value="UpperAlpha">UpperAlpha</asp:ListItem>
            <asp:ListItem Value="LowerRoman">LowerRoman</asp:ListItem>
            <asp:ListItem Value="UpperRoman">UpperRoman</asp:ListItem>
            <asp:ListItem>Disc</asp:ListItem>
            <asp:ListItem>Circle</asp:ListItem>
            <asp:ListItem>Square</asp:ListItem>
            <asp:ListItem>CustomImage</asp:ListItem>
            <asp:ListItem Value="NotSet">NotSet</asp:ListItem>
        </asp:ListBox>
        <hr />
        <asp:Label ID="Message" runat="server" AssociatedControlID="BulletStylesListBox" />
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>BulletStyle Example</title>
<script runat="server">       
        Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
            ' Change the message displayed, based on 
            ' the style selected from the list box.
            If BulletStylesListBox.SelectedIndex > -1 Then
                Message.Text = "You selected bullet style: " & BulletStylesListBox.SelectedItem.Text
            End If

            ' Change the bullet style used, based on 
            ' the style selected from the list box.
            Select Case (BulletStylesListBox.SelectedIndex)
                Case 0
                    ItemsBulletedList.BulletStyle = BulletStyle.Numbered
                Case 1
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerAlpha
                Case 2
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperAlpha
                Case 3
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerRoman
                Case 4
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperRoman
                Case 5
                    ItemsBulletedList.BulletStyle = BulletStyle.Disc
                Case 6
                    ItemsBulletedList.BulletStyle = BulletStyle.Circle
                Case 7
                    ItemsBulletedList.BulletStyle = BulletStyle.Square
                Case 8
                    ItemsBulletedList.BulletStyle = BulletStyle.CustomImage
                    ' Specify the path to the custom image to use for the bullet.
                    ItemsBulletedList.BulletImageUrl = "Images/image1.jpg"
                Case 9
                    Message.Text = "You selected NotSet. The browser will determine the bullet style."
                Case Else
                    Throw New Exception("You did not select a valid bullet style.")
            End Select

        End Sub

</script>

</head>
<body>
    <form id="form1" runat="server"> 

        <h3>BulletStyle Example</h3>

        <asp:BulletedList id="ItemsBulletedList"             
            DisplayMode="Text" 
            BulletStyle="NotSet"
            runat="server">    
                <asp:ListItem Value="0">Coho Winery</asp:ListItem>
                <asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
                <asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
            </asp:BulletedList>        

            <hr />

        <h4>Select a bullet type:</h4>        
        <asp:ListBox id="BulletStylesListBox" 
            SelectionMode="Single"
            Rows="1" 
            OnSelectedIndexChanged="Index_Changed"
            AutoPostBack="True"
            runat="server">         
                <asp:ListItem Value="Numbered">Numbered</asp:ListItem>
                <asp:ListItem Value="LowerAlpha">LowerAlpha</asp:ListItem>
                <asp:ListItem Value="UpperAlpha">UpperAlpha</asp:ListItem>
                <asp:ListItem Value="LowerRoman">LowerRoman</asp:ListItem>
                <asp:ListItem Value="UpperRoman">UpperRoman</asp:ListItem>
                <asp:ListItem>Disc</asp:ListItem>
                <asp:ListItem>Circle</asp:ListItem>
                <asp:ListItem>Square</asp:ListItem>
                <asp:ListItem>CustomImage</asp:ListItem>       
                <asp:ListItem Value="NotSet">NotSet</asp:ListItem>
        </asp:ListBox>        
            
        <hr />

        <asp:Label id="Message" 
            runat="server"
            AssociatedControlID="BulletStylesListBox"/>            
                  
   </form>
</body>
</html>

Комментарии

BulletStyle Перечисление представляет стиль маркеров, которые можно применить к элементам списка в BulletedList элемента управления.The BulletStyle enumeration represents the bullet styles that you can apply to the list items in a BulletedList control. BulletStyle Свойство использует эти значения перечисления, чтобы задать стиль маркеров BulletedList элемента управления.The BulletStyle property uses these enumeration values to set the bullet styles in a BulletedList control. Например, если задать BulletStyle свойства Disc, каждый элемент списка в BulletedList элемент управления отрисовывается круг с заливкой, предшествующие содержимое элемента списка, следующим образом:For example, if you set the BulletStyle property to Disc, each list item in a BulletedList control will render a filled circle preceding the content of the list item as follows:

  • Элемент списка 1List Item 1

  • Элемент списка 2List Item 2

  • Элемент списка 3List Item 3

Указание CustomImage стилем позволяет предоставить свой собственный образ для маркера.Specifying the CustomImage bullet style allows you to supply your own image for the bullet. Если указать CustomImage стиль маркированного списка, необходимо также задать BulletImageUrl URL-адрес пользовательского образа для использования.If you specify the CustomImage bullet style, you must also set the BulletImageUrl property to the URL of the custom image to use.

Если указать NotSet, браузер, в котором отображается элемент управления будет определяет стиль маркера для отображения с элементами списка в BulletedList элемента управления.If you specify NotSet, the browser in which the control is rendered will determine the bullet style to display with the list items in the BulletedList control.

Применяется к

Дополнительно