-(* Copyright (C) 2004, HELM Team.
+(* Copyright (C) 2004-2005, HELM Team.
*
* This file is part of HELM, an Hypertextual, Electronic
* Library of Mathematics, developed at the Computer Science
win:GWindow.window -> check:GMenu.check_menu_item -> unit
val toggle_win:
- ?check:GMenu.check_menu_item -> GWindow.window -> (unit -> unit)
+ ?check:GMenu.check_menu_item -> GWindow.window -> unit -> unit
val add_key_binding: Gdk.keysym -> (unit -> 'a) -> GBin.event_box -> unit
+(** Connect a callback to the clicked signal of a button, ignoring its return
+ * value *)
+val connect_button: #GButton.button -> (unit -> unit) -> unit
+
+(** Like connect_button above, but connects a callback to the activate signal of
+ * a menu item *)
+val connect_menu_item: #GMenu.menu_item -> (unit -> unit) -> unit
+
+ (** connect a unit -> unit callback to a particular key press event. Event can
+ * be specified using its keysym and a list of modifiers which must be in
+ * effect for the callback to be executed. Further signal processing of other
+ * key press events remains unchanged; further signal processing of the
+ * specified key press depends on the stop parameter *)
+val connect_key:
+ GObj.event_ops ->
+ ?modifiers:Gdk.Tags.modifier list ->
+ ?stop:bool -> (* stop signal handling when the given key has been pressed?
+ * Defaults to false *)
+ Gdk.keysym -> (* (= int) the key, see GdkKeysyms.ml *)
+ (unit -> unit) -> (* callback *)
+ unit
+
(** single string column list *)
class stringListModel:
GTree.view ->
(** {2 Matita GUI components} *)
class type gui =
- object
- method newUriDialog: unit -> MatitaGeneratedGui.uriChoiceDialog
+ object (* minimal gui object requirements *)
+ method newUriDialog: unit -> MatitaGeneratedGui.uriChoiceDialog
+ method newInterpDialog: unit -> MatitaGeneratedGui.interpChoiceDialog
+ method newConfirmationDialog: unit -> MatitaGeneratedGui.confirmationDialog
+ method newEmptyDialog: unit -> MatitaGeneratedGui.emptyDialog
end
-exception No_choice
+ (** {3 Dialogs} *)
- (** @raise No_choice *)
-val interactive_user_uri_choice:
+ (** @return true if user hit "ok" button, false if user hit "cancel" button
+ * @param cancel if set to true a cancel button is shown to the user, otherwise
+ * it is not (and indeed the function will return true). Defaults to true *)
+val ask_confirmation:
gui:#gui ->
- selection_mode:Gtk.Tags.selection_mode -> title:string -> msg:string ->
- ?nonvars_button:bool ->
- string list ->
- string list
+ ?cancel:bool -> ?title:string -> ?msg:string -> unit ->
+ bool
+
+ (** @param multiline (default: false) if true a TextView widget will be used
+ * for prompting the user otherwise a TextEntry widget will be
+ * @return the string given by the user *)
+val ask_text:
+ gui:#gui -> ?title:string -> ?msg:string -> ?multiline:bool -> unit -> string