FLTK 1.3.4
fl_ask.H
Go to the documentation of this file.
1 //
2 // "$Id: fl_ask.H 10501 2014-12-20 15:00:27Z manolo $"
3 //
4 // Standard dialog header file for the Fast Light Tool Kit (FLTK).
5 //
6 // Copyright 1998-2011 by Bill Spitzak and others.
7 //
8 // This library is free software. Distribution and use rights are outlined in
9 // the file "COPYING" which should have been included with this file. If this
10 // file is missing or damaged, see the license at:
11 //
12 // http://www.fltk.org/COPYING.php
13 //
14 // Please report all bugs and problems on the following page:
15 //
16 // http://www.fltk.org/str.php
17 //
18 
23 #ifndef fl_ask_H
24 # define fl_ask_H
25 
26 # include "Enumerations.H"
27 
28 class Fl_Widget;
29 
32 enum Fl_Beep {
39 };
40 
41 # ifdef __GNUC__
42 /* the GNUC-specific attribute appearing below in prototypes with a variable list of arguments
43  helps detection of mismatches between format string and argument list at compilation time */
44 # define __fl_attr(x) __attribute__ (x)
45 # else
46 # define __fl_attr(x)
47 # endif // __GNUC__
48 
49 FL_EXPORT void fl_beep(int type = FL_BEEP_DEFAULT);
50 FL_EXPORT void fl_message(const char *,...) __fl_attr((__format__ (__printf__, 1, 2)));
51 FL_EXPORT void fl_alert(const char *,...) __fl_attr((__format__ (__printf__, 1, 2)));
52 // fl_ask() is deprecated since it uses "Yes" and "No" for the buttons,
53 // which does not conform to the current FLTK Human Interface Guidelines.
54 // Use fl_choice() instead with the appropriate verbs instead.
55 FL_EXPORT int fl_ask(const char *,...) __fl_attr((__format__ (__printf__, 1, 2), __deprecated__));
56 FL_EXPORT int fl_choice(const char *q,const char *b0,const char *b1,const char *b2,...) __fl_attr((__format__ (__printf__, 1, 5)));
57 FL_EXPORT const char *fl_input(const char *label, const char *deflt = 0, ...) __fl_attr((__format__ (__printf__, 1, 3)));
58 FL_EXPORT const char *fl_password(const char *label, const char *deflt = 0, ...) __fl_attr((__format__ (__printf__, 1, 3)));
59 
60 FL_EXPORT Fl_Widget *fl_message_icon();
61 extern FL_EXPORT Fl_Font fl_message_font_;
62 extern FL_EXPORT Fl_Fontsize fl_message_size_;
63 inline void fl_message_font(Fl_Font f, Fl_Fontsize s) {
64  fl_message_font_ = f; fl_message_size_ = s;}
65 
66 FL_EXPORT void fl_message_hotspot(int enable);
67 FL_EXPORT int fl_message_hotspot(void);
68 
69 FL_EXPORT void fl_message_title(const char *title);
70 FL_EXPORT void fl_message_title_default(const char *title);
71 
72 // pointers you can use to change FLTK to a foreign language:
73 extern FL_EXPORT const char* fl_no;
74 extern FL_EXPORT const char* fl_yes;
75 extern FL_EXPORT const char* fl_ok;
76 extern FL_EXPORT const char* fl_cancel;
77 extern FL_EXPORT const char* fl_close;
78 #endif // !fl_ask_H
79 
80 //
81 // End of "$Id: fl_ask.H 10501 2014-12-20 15:00:27Z manolo $".
82 //
Fl_Widget is the base class for all widgets in FLTK.
Definition: Fl_Widget.H:101
Message beep.
Definition: fl_ask.H:34
FL_EXPORT const char * fl_close
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:275
void fl_alert(const char *fmt,...)
Shows an alert message dialog box.
Definition: fl_ask.cxx:361
void fl_message(const char *fmt,...)
Shows an information message dialog box.
Definition: fl_ask.cxx:338
Error beep.
Definition: fl_ask.H:35
Password beep.
Definition: fl_ask.H:37
FL_EXPORT int FL_EXPORT const char FL_EXPORT const char FL_EXPORT Fl_Widget * fl_message_icon()
Gets the Fl_Box icon container of the current default dialog used in many common dialogs like fl_mess...
Definition: fl_ask.cxx:477
Question beep.
Definition: fl_ask.H:36
int fl_choice(const char *fmt, const char *b0, const char *b1, const char *b2,...)
Shows a dialog displaying the printf style fmt message, this dialog features up to 3 customizable cho...
Definition: fl_ask.cxx:459
const char * fl_password(const char *fmt, const char *defstr,...)
Shows an input dialog displaying the fmt message.
Definition: fl_ask.cxx:531
Notification beep.
Definition: fl_ask.H:38
FL_EXPORT const char * fl_yes
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:272
This file contains type definitions and general enumerations.
FL_EXPORT void fl_message_title(const char *title)
Sets the title of the dialog window used in many common dialogs.
Definition: fl_ask.cxx:586
const char * fl_input(const char *fmt, const char *defstr,...)
Shows an input dialog displaying the fmt message.
Definition: fl_ask.cxx:505
FL_EXPORT const char * fl_no
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:271
FL_EXPORT void fl_beep(int type=FL_BEEP_DEFAULT)
Emits a system beep message.
Definition: fl_ask.cxx:283
int Fl_Fontsize
Size of a font in pixels.
Definition: Enumerations.H:906
FL_EXPORT void fl_message_title_default(const char *title)
Sets the default title of the dialog window used in many common dialogs.
Definition: fl_ask.cxx:607
FL_EXPORT const char * fl_ok
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:273
Fl_Beep
Different system beeps available.
Definition: fl_ask.H:32
Default beep.
Definition: fl_ask.H:33
int Fl_Font
A font number is an index into the internal font table.
Definition: Enumerations.H:877
FL_EXPORT const char * fl_cancel
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:274
int fl_ask(const char *fmt,...)
Shows a dialog displaying the fmt message, this dialog features 2 yes/no buttons. ...
Definition: fl_ask.cxx:390
const char * label() const
Gets the current label text.
Definition: Fl_Widget.H:421
FL_EXPORT void fl_message_hotspot(int enable)
Sets whether or not to move the common message box used in many common dialogs like fl_message()...
Definition: fl_ask.cxx:555
uchar type() const
Gets the widget type.
Definition: Fl_Widget.H:274