Exportar (0) Imprimir
Expandir todo

BulletedList.BulletStyle (Propiedad)

Obtiene o establece el estilo de viñeta del control BulletedList.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public virtual BulletStyle BulletStyle { get; set; }
/** @property */
public BulletStyle get_BulletStyle ()

/** @property */
public void set_BulletStyle (BulletStyle value)

public function get BulletStyle () : BulletStyle

public function set BulletStyle (value : BulletStyle)

No aplicable.

Valor de propiedad

Uno de los valores de BulletStyle. El valor predeterminado es NotSet.

Tipo de excepciónCondición

ArgumentOutOfRangeException

El tipo especificado no es ninguno de los valores de BulletStyle.

Utilice la propiedad BulletStyle para especificar el estilo de viñeta que se aplica a los elementos de lista en un control BulletedList. La propiedad BulletStyle se establece mediante uno de los valores de la enumeración BulletStyle. En la siguiente tabla se enumeran los posibles valores.

Estilo de viñeta

Descripción

NotSet

No establecido.

Numbered

Un número.

LowerAlpha

Una letra minúscula.

UpperAlpha

Una letra mayúscula.

LowerRoman

Un número romano en minúsculas.

UpperRoman

Un número romano en mayúsculas.

Disc

Un círculo relleno.

Circle

Un círculo vacío.

Square

Un cuadrado relleno.

CustomImage

Una imagen personalizada.

El valor de CustomImage permite proporcionar una imagen personalizada para la viñeta. Si se especifica el valor de CustomImage, también se deberá establecer la propiedad BulletImageUrl en la dirección URL de la imagen personalizada que se utilizará.

NotaNota:

El control BulletedList no admite la propiedad AlternateText porque las viñetas son intrínsecamente ornamentales, y no aportan información adicional que deba trasladarse por medio de la tecnología de asistencia. No obstante, si desea usar una imagen personalizada para trasladar al usuario un concepto, agregue texto adicional a cada elemento de la lista con viñetas o use un control que permita especificar un texto alternativo para cada imagen.

El valor de esta propiedad se almacena en el estado de vista.

En el ejemplo de código siguiente se muestra cómo se crea un control BulletedList. Un control ListBox se rellena con todos los valores de la enumeración BulletStyle disponibles. El estilo de viñeta varía según el estilo que el usuario selecciona en el cuadro de lista.


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

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft