虚拟方法
GtkWidgetkeynav_failed
声明 [源代码]
gboolean
keynav_failed (
GtkWidget* widget,
GtkDirectionType direction
)
描述 [源代码]
在票价上发出Gtk.Widget::keynav-failed
信号。
每当单个小部件内的键盘导航遇到边界时,应该调用此函数。
此函数的返回值应该类似于gtk_widget_child_focus()
的返回值。如果返回true,则留在小部件中,失败的键盘导航是正常的,或者没有地方可以/应该移动焦点。如果返回false,则调用方应该继续在小部件外进行键盘导航,例如通过在小部件的最顶层调用gtk_widget_child_focus()
。
默认的Gtk.Widget::keynav-failed
处理程序对GTK_DIR_TAB_FORWARD
和GTK_DIR_TAB_BACKWARD
返回false。对于GtkDirectionType
的其他值,返回true。
默认处理程序返回true时,它还调用gtk_widget_error_bell()
来通知用户失败的键盘导航。
提供自己的::keynav-failed
实现(通过连接到它或覆盖它)的一个用例是GtkEntry
小部件的行,用户应该能够使用箭头键遍历整个行,例如,从需要输入许可证密钥的用户界面中熟知。
参数
方向
-
类型:
GtkDirectionType
焦点移动方向。