FLTK 1.3.2
fl_ask.H
1 //
2 // "$Id: fl_ask.H 8864 2011-07-19 04:49:30Z greg.ercolano $"
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 
19 #ifndef fl_ask_H
20 # define fl_ask_H
21 
22 # include "Enumerations.H"
23 
24 class Fl_Widget;
26 enum {
27  FL_BEEP_DEFAULT = 0,
28  FL_BEEP_MESSAGE,
29  FL_BEEP_ERROR,
30  FL_BEEP_QUESTION,
31  FL_BEEP_PASSWORD,
32  FL_BEEP_NOTIFICATION
33 };
34 
35 # ifdef __GNUC__
36 # define __fl_attr(x) __attribute__ (x)
37 # else
38 # define __fl_attr(x)
39 # endif // __GNUC__
40 
41 FL_EXPORT void fl_beep(int type = FL_BEEP_DEFAULT);
42 FL_EXPORT void fl_message(const char *,...) __fl_attr((__format__ (__printf__, 1, 2)));
43 FL_EXPORT void fl_alert(const char *,...) __fl_attr((__format__ (__printf__, 1, 2)));
44 // fl_ask() is deprecated since it uses "Yes" and "No" for the buttons,
45 // which does not conform to the current FLTK Human Interface Guidelines.
46 // Use fl_choice() instead with the appropriate verbs instead.
47 FL_EXPORT int fl_ask(const char *,...) __fl_attr((__format__ (__printf__, 1, 2), __deprecated__));
48 FL_EXPORT int fl_choice(const char *q,const char *b0,const char *b1,const char *b2,...) __fl_attr((__format__ (__printf__, 1, 5)));
49 FL_EXPORT const char *fl_input(const char *label, const char *deflt = 0, ...) __fl_attr((__format__ (__printf__, 1, 3)));
50 FL_EXPORT const char *fl_password(const char *label, const char *deflt = 0, ...) __fl_attr((__format__ (__printf__, 1, 3)));
51 
52 FL_EXPORT Fl_Widget *fl_message_icon();
53 extern FL_EXPORT Fl_Font fl_message_font_;
54 extern FL_EXPORT Fl_Fontsize fl_message_size_;
55 inline void fl_message_font(Fl_Font f, Fl_Fontsize s) {
56  fl_message_font_ = f; fl_message_size_ = s;}
57 
58 FL_EXPORT void fl_message_hotspot(int enable);
59 FL_EXPORT int fl_message_hotspot(void);
60 
61 FL_EXPORT void fl_message_title(const char *title);
62 FL_EXPORT void fl_message_title_default(const char *title);
63 
64 // pointers you can use to change FLTK to a foreign language:
65 extern FL_EXPORT const char* fl_no;
66 extern FL_EXPORT const char* fl_yes;
67 extern FL_EXPORT const char* fl_ok;
68 extern FL_EXPORT const char* fl_cancel;
69 extern FL_EXPORT const char* fl_close;
70 #endif // !fl_ask_H
71 
72 //
73 // End of "$Id: fl_ask.H 8864 2011-07-19 04:49:30Z greg.ercolano $".
74 //
Fl_Widget is the base class for all widgets in FLTK.
Definition: Fl_Widget.H:100
FL_EXPORT const char * fl_close
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:270
void fl_alert(const char *fmt,...)
Shows an alert message dialog box.
Definition: fl_ask.cxx:355
void fl_message(const char *fmt,...)
Shows an information message dialog box.
Definition: fl_ask.cxx:332
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:428
int fl_choice(const char *fmt, const char *b0, const char *b1, const char *b2,...)
Shows a dialog displaying the fmt message, this dialog features up to 3 customizable choice buttons...
Definition: fl_ask.cxx:410
const char * fl_password(const char *fmt, const char *defstr,...)
Shows an input dialog displaying the fmt message.
Definition: fl_ask.cxx:481
FL_EXPORT const char * fl_yes
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:267
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:536
const char * fl_input(const char *fmt, const char *defstr,...)
Shows an input dialog displaying the fmt message.
Definition: fl_ask.cxx:455
FL_EXPORT const char * fl_no
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:266
FL_EXPORT void fl_beep(int type=FL_BEEP_DEFAULT)
Emits a system beep message.
Definition: fl_ask.cxx:277
int Fl_Fontsize
Size of a font in pixels.
Definition: Enumerations.H:746
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:557
FL_EXPORT const char * fl_ok
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:268
int Fl_Font
A font number is an index into the internal font table.
Definition: Enumerations.H:717
FL_EXPORT const char * fl_cancel
string pointer used in common dialogs, you can change it to another language
Definition: fl_ask.cxx:269
int fl_ask(const char *fmt,...)
Shows a dialog displaying the fmt message, this dialog features 2 yes/no buttons. ...
Definition: fl_ask.cxx:380
const char * label() const
Gets the current label text.
Definition: Fl_Widget.H:409
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:505
uchar type() const
Gets the widget type.
Definition: Fl_Widget.H:262