工具提示物件(Tooltips)就是當滑鼠指標移到按鈕或其它元件上並停留幾秒時,彈出的字串。工具提示對象很容易使用,所以在此僅僅對它們進行解釋,不再舉例。如果你想要看些程式碼,可以看看 GTK 附帶的testgtk.c程式.
不接收事件的元件(沒有自己的 X 視窗的元件)不能和工具提示物件一起工作。
可以使用 gtk_tooltips_new() 函式創建工具提示物件。因為GtkTooltips物件可以重複使用,一般在應用程式中僅需要呼叫這個函式一次。
GtkTooltips *gtk_tooltips_new( void ); |
一旦已創建新的工具提示,並且希望在某個元件上應用它,可呼叫以下函式設置它:
void gtk_tooltips_set_tip( GtkTooltips *tooltips, GtkWidget *widget, const gchar *tip_text, const gchar *tip_private ); |
第一個參數是已經創建的工具提示物件,其後第二個參數是希望彈出工具提示的元件,第三個參數是要彈出的文字。最後一個參數是作為標識符的字串,當用GtkTipsQuery實現上下文敏感的幫助時要引用該標識符。目前,你可以把它設置為NULL.
下面有個簡短範例:
GtkTooltips *tooltips; GtkWidget *button; . . . tooltips = gtk_tooltips_new (); button = gtk_button_new_with_label ("button 1"); . . . gtk_tooltips_set_tip (tooltips, button, "This is button 1", NULL); |
還有其它與工具提示有關的函式,下面僅僅列出一些函式的簡要描述。
void gtk_tooltips_enable( GtkTooltips *tooltips ); |
啟用已經停用的工具提示物件。
void gtk_tooltips_disable( GtkTooltips *tooltips ); |
停用已經啟用的工具提示物件。
上面是所有與工具提示有關的函式,實際上比你想要知道的還多 🙂
1 則留言