Прочитать на английском

Поделиться через

BulletStyle Перечисление

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Задает стиль маркеров, который можно применить к элементам списка в элементе управления BulletedList.

public enum BulletStyle
Наследование
Object
ValueType
Enum
BulletStyle

Поля

Имя Значение Описание
Circle 7

Стилем маркеров становится окружность.
CustomImage 9

Стилем маркеров становится пользовательское изображение.
Disc 6

Стилем маркеров становится заполненный кружок.
LowerAlpha 2

Стилем маркеров становятся буквы в нижнем регистре (а, б, в, ...).
LowerRoman 4

Стилем маркеров становятся римские цифры в нижнем регистре (i, ii, iii, ...).
NotSet 0

Стиль маркеров не указан. Стиль маркеров определяется браузером, отображающим элемент управления BulletedList.
Numbered 1

Стилем маркеров становится число (1, 2, 3, ...).
Square 8

Стилем маркеров становится заполненный квадрат.
UpperAlpha 3

Стилем маркеров становятся буквы в верхнем регистре (А, Б, В, ...).
UpperRoman 5

Стилем маркеров становятся римские цифры в верхнем регистре (I, II, III, ...).

Примеры

В следующем примере показано, как создать BulletedList элемент управления . Элемент ListBox управления заполняется всеми доступными BulletStyle значениями перечисления. Стиль маркера изменяется в зависимости от стиля, выбранного пользователем в списке.


<%@ 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>

Комментарии

Перечисление BulletStyle представляет стили маркеров, которые можно применить к элементам списка в элементе BulletedList управления . Свойство BulletStyle использует эти значения перечисления для задания стилей маркеров в элементе BulletedList управления . Например, если для свойства задано значение BulletStyleDisc, каждый элемент списка в элементе BulletedList управления будет отображать заполненный круг перед содержимым элемента списка следующим образом:

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

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

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

Указание стиля маркера CustomImage позволяет указать собственный образ для маркера. При указании стиля маркера CustomImage необходимо также задать BulletImageUrl для свойства URL-адрес используемого пользовательского образа.

Если указать NotSet, браузер, в котором отображается элемент управления, определит стиль маркера для отображения элементов списка в элементе BulletedList управления .

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

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

См. также раздел