Click or drag to resize
KaxTextBoxTextMode Property
Gets or sets the behavior mode (single-line, multiline, or password) of the KaxTextBox control.

Namespace: Kettic.AspNet.Controls
Assembly: Kettic.AspNet.Controls (in Kettic.AspNet.Controls.dll) Version: 2014.4.1129.0 (2014.04.1129.0)
Syntax
Copy
public InputMode TextMode { get; set; }

Property Value

Type: InputMode
One of the KaxInputTextBoxMode enumeration values. The default value is SingleLine.
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionThe specified mode is not one of the TextBoxMode enumeration values.
Remarks

Use the TextMode property to specify whether a KaxTextBox control is displayed as a single-line, multiline, or password text box.

When the KaxTextBox control is in multiline mode, you can control the number of rows displayed by setting the Rows property. You can also specify whether the text should wrap by setting the Wrap property.

If the KaxTextBox control is in password mode, all characters entered in the control are masked.

This property cannot be set by themes or style sheet themes

Examples
The following code example demonstrates how to use the KaxTextMode property to specify a multiline text box. This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements.
Visual Basic
Copy
<%@ Page Language="VB" AutoEventWireup="True" %>

<%@ Register Assembly="KaxInput.Net2" Namespace="Kettic.AspNetControls" TagPrefix="kaxI" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <title>MultiLine KaxTextBox Example </title>

    <script runat="server">

      Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )

         Message.Text = "Thank you for your comment: <br />" + Comment.Text

      End Sub

      Protected Sub Check_Change(sender As Object, e As EventArgs )

         Comment.Wrap = WrapCheckBox.Checked
         Comment.ReadOnly = ReadOnlyCheckBox.Checked

      End Sub

    </script>

</head>
<body>
    <form id="form1" runat="server">
        <h3>
            MultiLine KaxTextBox Example
        </h3>
        Please enter a comment and click the submit button.
        <br />
        <br />
        <kaxI:KaxTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
        <br />
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
            ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
        <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
            OnCheckedChanged="Check_Change" runat="server" />

        <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
            OnCheckedChanged="Check_Change" runat="server" />

        <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
        <hr />
        <asp:Label ID="Message" runat="server" />
    </form>
</body>
</html>
C#
Copy
<%@ Page Language="C#" AutoEventWireup="True" %>

<%@ Register Assembly="KaxInput.Net2" Namespace="Kettic.AspNetControls" TagPrefix="kaxI" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <title>MultiLine KaxTextBox Example </title>

    <script runat="server">

        protected void SubmitButton_Click(Object sender, EventArgs e)
        {

            Message.Text = "Thank you for your comment: <br />" + Comment.Text;

        }

        protected void Check_Change(Object sender, EventArgs e)
        {

            Comment.Wrap = WrapCheckBox.Checked;
            Comment.ReadOnly = ReadOnlyCheckBox.Checked;

        }

    </script>

</head>
<body>
    <form id="form1" runat="server">
        <h3>
            MultiLine KaxTextBox Example
        </h3>
        Please enter a comment and click the submit button.
        <br />
        <br />
        <kaxI:KaxTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
        <br />
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
            ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
        <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
            OnCheckedChanged="Check_Change" runat="server" />

        <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
            OnCheckedChanged="Check_Change" runat="server" />

        <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
        <hr />
        <asp:Label ID="Message" runat="server" />
    </form>
</body>
</html>
See Also