Share via


顯示工具提示

.NET 多平臺應用程式 UI (.NET MAUI) 工具提示是小型矩形快顯,當使用者將指標放在 檢視上時,會顯示檢視用途的簡短描述。 通常當使用者將指標停留在相關聯的檢視上方時,工具提示會自動顯示:

  • 在 Android 上,當使用者長按檢視時,會顯示工具提示。 在長按放開之後,工具提示會保持可見數秒。
  • 在 iOS 上,若要顯示工具提示,您的應用程式必須是使用 Apple 晶片在 Mac 上執行的 iPhone 或 iPad 應用程式。 提供符合此準則時,當指標置於檢視上方幾秒鐘,並維持可見狀態,直到指標離開檢視時,才會顯示工具提示。 iOS 上的工具提示需要使用 iOS 15.0+ 。 如需在 Mac 上使用 iPhone 和 iPad 應用程式搭配 Apple 晶片的詳細資訊,請參閱 搭配 Apple 晶片在 Mac 上使用 iPhone 和 iPad 應用程式
  • 在 Mac 上,當指標置於檢視上方幾秒鐘時,會顯示工具提示。 工具提示會保持可見,直到指標離開檢視為止。 MacCat 上的工具提示需要使用 Mac Dip 15.0+ 。
  • 在 Windows 上,當指標停留在檢視上時,會顯示工具提示。 工具提示會保持可見數秒,或直到指標停止停留在檢視上方為止。

工具提示是藉由將檢視上的附加屬性設定 ToolTipProperties.Textstring 來定義:

<Button Text="Save"
        ToolTipProperties.Text="Click to Save your data" />

對等的 C# 程式碼為:

Button button = new Button { Text = "Save" };
ToolTipProperties.SetText(button, "Click to Save your data");

如需附加屬性的詳細資訊,請參閱 附加屬性

根據預設,工具提示會顯示在指標上方中央:

按鈕上方工具提示的螢幕擷取畫面。

注意

目前不支援設定工具提示放置。