WebControl.ToolTip WebControl.ToolTip WebControl.ToolTip WebControl.ToolTip Property

定義

マウス ポインターが Web サーバー コントロールの上を移動したときに表示されるテキストを取得または設定します。Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

public:
 virtual property System::String ^ ToolTip { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string ToolTip { get; set; }
member this.ToolTip : string with get, set
Public Overridable Property ToolTip As String

プロパティ値

マウス ポインターが Web サーバー コントロールの上を移動したときに表示されるテキスト。The text displayed when the mouse pointer hovers over the Web server control. 既定値は、Empty です。The default is Empty.

次の例を設定する方法を示しています、ToolTipプロパティをButtonコントロールから継承される、WebControl基本クラス。The following example illustrates how to set the ToolTip property on the Button control, which is inherited from the WebControl base class.

注意

次のコード サンプルでは、1 つのファイル コード モデルを使用して、分離コード ファイルに直接コピーすると、正常に動作しない可能性があります。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. このコード サンプルは、.aspx 拡張子を持つ空のテキスト ファイルにコピーする必要があります。This code sample must be copied into an empty text file that has an .aspx extension. Web フォームのコード モデルの詳細については、次を参照してください。 ASP.NET Web フォーム ページのコード モデルします。For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

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

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

<script runat="server">
 
    void SubmitBtn_Click(object sender, EventArgs e)
    {
        if (((Button)sender).CommandArgument == "1")
            Label1.Text = "Share your happiness!";
        else
            Label1.Text = "Be happy!";

        Label1.BorderColor = System.Drawing.Color.BurlyWood;
        Label1.BorderWidth = 4;
    }
 
 </script>
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head runat="server">
    <title>WebControl.ToolTip Example</title>
 </head>
 <body>
 <form id="Form1" runat="server">
 
    <h3>ToolTip Property of a Web Control</h3>
    <p>Don't know which button to click?<br />
        Move the mouse pointer over the buttons to find out!
    </p>

    <p><asp:Button id="SubmitBtn1" OnClick="SubmitBtn_Click" 
            Text="Click Me" CommandArgument="1"
            ToolTip="Click me if you are happy" runat="server"/>
    </p>

    <p><asp:Button id="SubmitBtn2" OnClick="SubmitBtn_Click" 
            Text="Click Me" CommandArgument="2"
            ToolTip="Click me if you are sad." runat="server"/>
    </p>

    <asp:Label id="Label1" Font-size="24pt" Font-Bold="True" 
        BackColor="Yellow" runat="server"/>

 </form>
 
 </body>
 </html>
<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <script language="VB" runat="server">
 
    Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
        If CType(sender, Button).CommandArgument = "1" Then
            Label1.Text = "Share your happiness!"
        Else
            Label1.Text = "Be happy!"
        End If
        Label1.BorderColor = Drawing.Color.BurlyWood
        Label1.BorderWidth = 4
    End Sub
 
 </script>
 
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head runat="server">
    <title>ToolTip Property of a Web Control</title>
</head>
<body>
  
 <form id="form1" runat="server">
 
    <h3>ToolTip Property of a Web Control</h3>
    <p>Don't know which button to click?<br />
        Move the mouse pointer over the buttons to find out!
    </p>

    <p><asp:Button id="SubmitBtn1" OnClick="SubmitBtn_Click" 
            Text="Click Me" CommandArgument="1"
            ToolTip="Click me if you are happy" runat="server"/>
    </p>

    <p><asp:Button id="SubmitBtn2" OnClick="SubmitBtn_Click" 
            Text="Click Me" CommandArgument="2"
            ToolTip="Click me if you are sad." runat="server"/>
    </p>

    <asp:Label id="Label1" Font-size="24pt" Font-Bold="True" 
        BackColor="Yellow" runat="server"/>

 </form>
 
 </body>
 </html>
 

注釈

使用して、ToolTipプロパティをカスタム Web サーバー コントロールにマウス ポインターを合わせたときに表示されるテキストを指定します。Use the ToolTip property to specify the custom text that is displayed when the mouse pointer hovers over the Web server control.

注意

このプロパティはすべてのブラウザーにレンダリングされます。This property is rendered for all browsers. ただし、Microsoft Internet Explorer だけでは、ツールヒントとしてこのプロパティが表示されます。However, only Microsoft Internet Explorer will display this property as a ToolTip. その他のすべてのブラウザーには、このプロパティは無視します。All other browsers will ignore this property.

このプロパティは、の値を設定すると、デザイナーのツールを使用してリソース ファイルに自動的に保存できます。The value of this property, when set, can be saved automatically to a resource file by using a designer tool. 詳細については、次を参照してください。LocalizableAttributeグローバリゼーションとローカリゼーションします。For more information, see LocalizableAttribute and Globalization and Localization.

適用対象

こちらもご覧ください