WebControl.ToolTip プロパティとは何？わかりやすく解説 Weblio辞書

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

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

WebControl.ToolTip プロパティ

マウスポインタが Web サーバーコントロールの上を移動したときに表示されるテキストを取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 ToolTip As String

Visual Basic (使用法)

Dim instance As WebControl
Dim value As String

value = instance.ToolTip

instance.ToolTip = value

[LocalizableAttribute(true)] 
public virtual string ToolTip { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property String^ ToolTip {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ToolTip ()

/** @property */
public void set_ToolTip (String value)

JScript

public function get ToolTip
 () : String

public function set ToolTip
 (value : String)

プロパティ値
マウスポインタが Web サーバーコントロールの上を移動したときに表示されるテキスト。既定値は String.Empty です。

解説

ToolTip プロパティを使用して、マウスポインタが Web サーバーコントロールの上を移動したときに表示されるカスタムテキストを指定します。

メモ
このプロパティは、すべてのブラウザで表示されます。ただし、このプロパティがツールヒントとして表示されるのは、Microsoft Internet Explorer だけです。他のすべてのブラウザでは、このプロパティは無視されます。

このプロパティの値は、設定時に、デザイナツールを使用してリソースファイルに自動的に保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーションの各トピックを参照してください。

使用例

WebControl 基本クラスから継承された、Button コントロールに ToolTip プロパティを設定する方法の例を次に示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<html>
 <body>
 
     <h3>ToolTip Property of a Web Control<br></h3>
 
 <script language="VB" runat="server">
 
    Sub SubmitBtn1_Click(sender As Object,
 e As EventArgs)
        Label1.Text = "Share your happiness with others!"
    End Sub

    Sub SubmitBtn2_Click(sender As Object,
 e As EventArgs)
        Label1.Text = "Don't worry, be very happy!"
    End Sub
 
 </script>
 
 <form runat=server>
 
     Don't know which button to click?
     <br>
     Move the mouse pointer over the buttons to find out!
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are happy" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn2" OnClick="SubmitBtn2_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are not too happy"
 runat="server"/>
     <p>
     
     <asp:Label id="Label1" Font-size=24 Font-Bold="True"
 BackColor="Yellow" runat="server"/>
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <body>
 
     <h3>ToolTip Property of a Web Control<br></h3>
 
 <script language="C#" runat="server">
 
     void SubmitBtn1_Click(Object sender, EventArgs e) {
     Label1.Text = "Share your happiness with others!";
     }
 
     void SubmitBtn2_Click(Object sender, EventArgs e) {
     Label1.Text = "Don't worry, be very happy!";
     }
 
 </script>
 
 <form runat=server>
 
     Don't know which button to click?
     <br>
     Move the mouse pointer over the buttons to find out!
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are
 happy" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn2" OnClick="SubmitBtn2_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are
 not too happy" runat="server"/>
     <p>
     
     <asp:Label id="Label1" Font-size=24 Font-Bold="True"
 BackColor="Yellow" runat="server"/>
 </form>
 
 </body>
 </html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <body>
 
     <h3>ToolTip Property of a Web Control<br></h3>
 
 <script language="JSCRIPT" runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs){
        Label1.Text = "Share your happiness with others!"
    }

    function SubmitBtn2_Click(sender : Object, e : EventArgs){
        Label1.Text = "Don't worry, be very happy!"
    }
 
 </script>
 
 <form runat=server>
 
     Don't know which button to click?
     <br>
     Move the mouse pointer over the buttons to find out!
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are
 happy" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn2" OnClick="SubmitBtn2_Click"
 
     Text="Click Me" 
     ToolTip="Click this one if you are
 not too happy" runat="server"/>
     <p>
     
     <asp:Label id="Label1" Font-size=24 Font-Bold="True"
 BackColor="Yellow" runat="server"/>
 </form>
 
 </body>
 </html>