WebControl.ToolTip-Eigenschaft

Artikel
08/20/2007

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property ToolTip As String
'Usage
Dim instance As WebControl
Dim value As String

value = instance.ToolTip

instance.ToolTip = value

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

[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)

public function get ToolTip () : String

public function set ToolTip (value : String)

Eigenschaftenwert

Der Text, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird. Der Standardwert ist String.Empty.

Hinweise

Mit der ToolTip-Eigenschaft können Sie den benutzerdefinierten Text angeben, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird.

Hinweis

Diese Eigenschaft wird von allen Browsern dargestellt. Allerdings zeigt nur Microsoft Internet Explorer diese Eigenschaft als Quickinfo an. Von allen anderen Browsern wird diese Eigenschaft ignoriert.

Der Wert dieser Eigenschaft (sofern festgelegt) kann mit einem Designertool automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und unter ASP.NET-Globalisierung und -Lokalisierung.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die ToolTip-Eigenschaft für das von der WebControl-Basisklasse vererbte Button-Steuerelement festgelegt wird.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ 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>

<%@ 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>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über