IEditableTextControl インターフェイスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IEditableTextControl インターフェイス

メモ : このインターフェイスは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが変更できるテキストを表示するコントロールを表します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Interface IEditableTextControl
    Inherits ITextControl

Visual Basic (使用法)

Dim instance As IEditableTextControl

public interface IEditableTextControl : ITextControl

C++

public interface class IEditableTextControl
 : ITextControl

public interface IEditableTextControl extends ITextControl

JScript

public interface IEditableTextControl extends
 ITextControl

解説

TextBox や、ListControl から派生するコントロールには、ページユーザーが変更できるテキストプロパティが用意されています。テキストプロパティが変更されると、プロパティが変更されたことをハンドラに通知するイベントが発生します。IEditableTextControl を実装するクラスは、TextChanged イベントを定義する必要があります。

IEditableTextControl インターフェイスには TextChanged イベントしか定義されていませんが、このインターフェイスは Text プロパティが定義されている ITextControl インターフェイスから継承します。IEditableTextControl インターフェイスを実装するには、Text プロパティと、サーバーへのポスト間で Text プロパティが変更された場合に発生する TextChanged イベントを、コントロールに定義する必要があります。

IEditableTextControl は、TextBox および ListControl によって実装されます。これらのクラスでは、ListControl.OnTextChanged メソッドまたは TextBox.OnTextChanged メソッドによりイベントが発生します。IEditableTextControl インターフェイスを実装するクラスは、同様のメソッドを定義して、イベントを発生させることができます。

使用例

TextChanged イベントを実装する方法を次のコード例に示します。

Visual Basic

Public Class customeditablebox
    Inherits System.Web.UI.UserControl
    Implements System.Web.UI.IEditableTextControl

    Private Shared ReadOnly
 EventCustomTextChanged As New Object

    Public Custom Event TextChanged As
 EventHandler _
      Implements System.Web.UI.IEditableTextControl.TextChanged
        AddHandler(ByVal value As
 EventHandler)
            Events.AddHandler(EventCustomTextChanged, value)
        End AddHandler

        RemoveHandler(ByVal value As
 EventHandler)
            Events.RemoveHandler(EventCustomTextChanged, value)
        End RemoveHandler

        RaiseEvent(ByVal sender As
 Object, ByVal e As EventArgs)

        End RaiseEvent
    End Event

    Public Property Text() As
 String _
      Implements System.Web.UI.IEditableTextControl.Text
        Get
            ' Provide implementation.
            Return String.Empty
        End Get
        Set(ByVal value As
 String)
            ' Provide implementation.
        End Set
    End Property
End Class

public partial class customeditablebox : System.Web.UI.UserControl,
 IEditableTextControl
{
    private static readonly object EventCustomTextChanged
 = new Object();

    public event EventHandler TextChanged
    {
        add
        {
            Events.AddHandler(EventCustomTextChanged, value);
        }
        remove
        {
            Events.RemoveHandler(EventCustomTextChanged, value);
        }
    }

    public string Text
    {
        get
        {
            // Provide implementation.
            return String.Empty;
        }
        set
        {
            // Provide implementation.
        }
    }
}