CheckBoxList.TextAlign-Eigenschaft
Ruft die Ausrichtung des Texts für die Kontrollkästchen in der Gruppe ab oder legt diese fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable Property TextAlign As TextAlign
'Usage
Dim instance As CheckBoxList
Dim value As TextAlign
value = instance.TextAlign
instance.TextAlign = value
public virtual TextAlign TextAlign { get; set; }
public:
virtual property TextAlign TextAlign {
TextAlign get ();
void set (TextAlign value);
}
/** @property */
public TextAlign get_TextAlign ()
/** @property */
public void set_TextAlign (TextAlign value)
public function get TextAlign () : TextAlign
public function set TextAlign (value : TextAlign)
Eigenschaftenwert
Einer der TextAlign-Werte. Der Standardwert ist Right.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die angegebene Ausrichtung für den Beschriftungstext ist keiner der TextAlign-Werte. |
Hinweise
Mit dieser Eigenschaft können Sie festlegen, ob der den Kontrollkästchen zugeordnete Text links oder rechts vom jeweiligen Kontrollkästchen angezeigt wird. Wenn diese Eigenschaft auf TextAlign.Right festgelegt ist, wird der Text rechts neben dem Kontrollkästchen angezeigt. Wenn diese Eigenschaft auf TextAlign.Left festgelegt ist, wird der Text links neben dem Kontrollkästchen angezeigt.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von CheckBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von CheckBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von CheckBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
Beispiel
Das folgende Codebeispiel veranschaulicht, wie mit der TextAlign-Eigenschaft angegeben wird, dass der den Kontrollkästchen zugeordnete Text auf der rechten Seite des CheckBoxList-Steuerelements angezeigt wird.
Hinweis
In den folgenden Codebeispielen wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Jedes Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
Dim i As Integer
Message.Text = "Selected Item(s):<br><br>"
For i=0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text += checkboxlist1.Items(i).Text + "<br>"
End If
Next
End Sub
</script>
</head>
<body>
<form action="checkboxlist.aspx" method="post" runat="server">
<h3>CheckBoxList Example</h3>
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script language="C#" runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
Message.Text = "Selected Item(s):<br><br>";
for (int i=0; i<checkboxlist1.Items.Count; i++)
{
if (checkboxlist1.Items[i].Selected)
Message.Text += checkboxlist1.Items[i].Text + "<br>";
}
}
</script>
</head>
<body>
<form action="checkboxlist.aspx" method="post" runat="server">
<h3>CheckBoxList Example</h3>
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JScript" runat="server">
function Check_Clicked(sender : Object, e : EventArgs)
{
Message.Text = "Selected Item(s):<br><br>";
for (var i : int = 0; i<checkboxlist1.Items.Count; i++)
{
if (checkboxlist1.Items[i].Selected)
Message.Text += checkboxlist1.Items[i].Text + "<br>";
}
}
</script>
</head>
<body>
<form action="checkboxlist.aspx" method="post" runat="server">
<h3>CheckBoxList Example</h3>
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Check_Clicked(sender as Object, e As EventArgs)
Message.Text = "Selected Item(s):<br><br>"
' Iterate through the Items collection of the CheckBoxList
' control and display the selected items.
Dim i As Integer
For i=0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text &= checkboxlist1.Items(i).Text & "<br>"
End If
Next
End Sub
Sub Index_Change(sender As Object, e As EventArgs)
' Set the alignment of the caption (right or left) in relation
' to the check boxes.
' Note that the TextAlign enumeration starts at 1 instead of 0,
' so the value of the SelectedIndex property cannot be used
' directly for casting into a TextAlign enumeration.
' In this example, the values of the TextAlign enumeration are
' stored in the Value property of each ListItem in the
' DropDownList control named List. To determine the enumeration
' value, retrieve the value of the Value property, convert it to
' an Int32, and then cast it to a TextAlign enumeration.
Dim EnumValue As Integer = Convert.ToInt32(List.SelectedItem.Value)
checkboxlist1.TextAlign = CType(EnumValue, TextAlign)
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> CheckBoxList TextAlign Example </h3>
Select items from the CheckBoxList.
<br><br>
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Table"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
<hr>
Select whether to display the captions to the right or the left
of the check boxes.
<table cellpadding="5">
<tr>
<td>
TextAlign:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="List"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Value="1">Left</asp:ListItem>
<asp:ListItem Value="2" Selected="True">Right</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
Message.Text = "Selected Item(s):<br><br>";
// Iterate through the Items collection of the CheckBoxList
// control and display the selected items.
for (int i=0; i<checkboxlist1.Items.Count; i++)
{
if (checkboxlist1.Items[i].Selected)
{
Message.Text += checkboxlist1.Items[i].Text + "<br>";
}
}
}
void Index_Change(Object sender, EventArgs e)
{
// Set the alignment of the caption (right or left) in relation
// to the check boxes.
// Note that the TextAlign enumeration starts at 1 instead of 0,
// so the value of the SelectedIndex property cannot be used
// directly for casting into a TextAlign enumeration.
// In this example, the values of the TextAlign enumeration are
// stored in the Value property of each ListItem in the
// DropDownList control named List. To determine the enumeration
// value, retrieve the value of the Value property, convert it to
// an Int32, and then cast it to a TextAlign enumeration.
int EnumValue = Convert.ToInt32(List.SelectedItem.Value);
checkboxlist1.TextAlign = (TextAlign)EnumValue;
}
</script>
</head>
<body>
<form runat="server">
<h3> CheckBoxList TextAlign Example </h3>
Select items from the CheckBoxList.
<br><br>
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Table"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
<hr>
Select whether to display the captions to the right or the left
of the check boxes.
<table cellpadding="5">
<tr>
<td>
TextAlign:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="List"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Value="1">Left</asp:ListItem>
<asp:ListItem Value="2" Selected="True">Right</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
CheckBoxList-Klasse
CheckBoxList-Member
System.Web.UI.WebControls-Namespace
TextAlign