snapshot

[helm.git] / helm / matita / matitaGtkMisc.mli

diff --git a/helm/matita/matitaGtkMisc.mli b/helm/matita/matitaGtkMisc.mli
index aef9e52f7ef3595b2f5aac864ac947cef383360d..5bb6fa09d55af6be82170e23a3ea4c3cc41b7d35 100644 (file)
--- a/helm/matita/matitaGtkMisc.mli
+++ b/helm/matita/matitaGtkMisc.mli
@@ -49,21 +49,28 @@ class stringListModel:
 (** {2 Matita GUI components} *)
 
 class type gui =
-  object
+  object  (* minimal gui object requirements *)
     method newUriDialog: unit -> MatitaGeneratedGui.uriChoiceDialog
-    method newConfirmationDialog :
-      title:string -> msg:string -> unit ->
-        MatitaGeneratedGui.confirmationDialog
+    method newConfirmationDialog: unit -> MatitaGeneratedGui.confirmationDialog
+    method newTextDialog: unit -> MatitaGeneratedGui.textDialog
   end
 
-(** {3 Dialogs} *)
+  (** {3 Dialogs} *)
+
+exception Cancel  (* raised when no answer is given by the user *)
 
-  (** @raise MatitaTypes.No_choice *)
+  (** @raise Cancel *)
 val interactive_user_uri_choice: gui:#gui -> MatitaTypes.choose_uris_callback
 
-  (** @raise MatitaTypes.No_choice *)
+  (** @raise Cancel *)
 val interactive_interp_choice: gui:#gui -> MatitaTypes.choose_interp_callback
 
   (** @return true if user hit "ok" button, false if user hit "cancel" button *)
 val ask_confirmation: gui:#gui -> ?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
+