WebControl.ToolTip Eigenschaft

Definition

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.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

Eigenschaftswert

Der Text, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird.The text displayed when the mouse pointer hovers over the Web server control. Die Standardeinstellung ist Empty.The default is Empty.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die ToolTip -Eigenschaft für Button das-Steuerelement festgelegt wird WebControl , die von der-Basisklasse geerbt wird.The following example illustrates how to set the ToolTip property on the Button control, which is inherited from the WebControl base class.

Hinweis

Im folgenden Codebeispiel wird das Einzel Datei-Code Modell verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine Code-Behind-Datei kopiert wird.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung ASPX kopiert werden.This code sample must be copied into an empty text file that has an .aspx extension. Weitere Informationen zum Web Forms-Code Modell finden Sie unter ASP.net Web Forms Page Code Model.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>
 

Hinweise

Verwenden Sie ToolTip die-Eigenschaft, um den benutzerdefinierten Text anzugeben, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserver Steuerelement gezeigt wird.Use the ToolTip property to specify the custom text that is displayed when the mouse pointer hovers over the Web server control.

Hinweis

Diese Eigenschaft wird für alle Browser gerendert.This property is rendered for all browsers. Diese Eigenschaft wird jedoch nur in Microsoft Internet Explorer als QuickInfo angezeigt.However, only Microsoft Internet Explorer will display this property as a ToolTip. Alle anderen Browser ignorieren diese Eigenschaft.All other browsers will ignore this property.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.For more information, see LocalizableAttribute and Globalization and Localization.

Gilt für:

Siehe auch