BulletStyle Énumération

Définition

Spécifie les styles de puce que vous pouvez appliquer aux éléments de liste dans un contrôle 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
Héritage
BulletStyle

Champs

Circle 7

Le style de puce est en forme de cercle vide.The bullet style is an empty circle shape.

CustomImage 9

Le style de puce est une image personnalisée.The bullet style is a custom image.

Disc 6

Le style de puce est en forme de cercle plein.The bullet style is a filled circle shape.

LowerAlpha 2

Le style de puce est une lettre minuscule (a, b, c, ...).The bullet style is a lowercase letter (a, b, c, ...).

LowerRoman 4

Le style de puce est un chiffre romain minuscule (i, ii, iii, ...).The bullet style is a lowercase Roman numeral (i, ii, iii, ...).

NotSet 0

Le style de puce n'est pas défini.The bullet style is not set. Le navigateur qui restitue le contrôle BulletedList déterminera le style de puce à afficher.The browser that renders the BulletedList control will determine the bullet style to display.

Numbered 1

Le style de puce est un nombre (1, 2, 3, ...).The bullet style is a number (1, 2, 3, ...).

Square 8

Le style de puce est en forme de carré plein.The bullet style is a filled square shape.

UpperAlpha 3

Le style de puce est une lettre majuscule (A, B, C, ...).The bullet style is an uppercase letter (A, B, C, ...).

UpperRoman 5

Le style de puce est un chiffre romain majuscule (I, II, III, ...).The bullet style is an uppercase Roman numeral (I, II, III, ...).

Exemples

L’exemple suivant montre comment créer un BulletedList contrôle.The following example demonstrates how to create a BulletedList control. Un ListBox contrôle est rempli avec toutes les BulletStyle valeurs d’énumération disponibles.A ListBox control is populated with all available BulletStyle enumeration values. Le style de puce change en fonction du style que l’utilisateur sélectionne dans la zone de liste.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>

Remarques

L' BulletStyle énumération représente les styles de puces que vous pouvez appliquer aux éléments de liste dans un BulletedList contrôle.The BulletStyle enumeration represents the bullet styles that you can apply to the list items in a BulletedList control. La BulletStyle propriété utilise ces valeurs d’énumération pour définir les styles de puces dans un BulletedList contrôle.The BulletStyle property uses these enumeration values to set the bullet styles in a BulletedList control. Par exemple, si vous affectez BulletStyle à la propriété la valeur Disc , chaque élément de liste d’un BulletedList contrôle restituera un cercle plein avant le contenu de l’élément de liste comme suit :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:

  • Élément de liste 1List Item 1

  • Élément de liste 2List Item 2

  • Élément de liste 3List Item 3

La spécification du CustomImage style de puce vous permet de fournir votre propre image pour la puce.Specifying the CustomImage bullet style allows you to supply your own image for the bullet. Si vous spécifiez le CustomImage style de puce, vous devez également affecter BulletImageUrl à la propriété l’URL de l’image personnalisée à utiliser.If you specify the CustomImage bullet style, you must also set the BulletImageUrl property to the URL of the custom image to use.

Si vous spécifiez NotSet , le navigateur dans lequel le contrôle est rendu détermine le style de puce à afficher avec les éléments de liste dans le BulletedList contrôle.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.

S’applique à

Voir aussi