| 1 | // ==================================================================== // |
|---|
| 2 | // // |
|---|
| 3 | // File : awt_advice.hxx // |
|---|
| 4 | // Purpose : general user advices // |
|---|
| 5 | // // |
|---|
| 6 | // // |
|---|
| 7 | // Coded by Ralf Westram (coder@reallysoft.de) in May 2002 // |
|---|
| 8 | // Copyright Department of Microbiology (Technical University Munich) // |
|---|
| 9 | // // |
|---|
| 10 | // Visit our web site at: http://www.arb-home.de/ // |
|---|
| 11 | // // |
|---|
| 12 | // // |
|---|
| 13 | // ==================================================================== // |
|---|
| 14 | |
|---|
| 15 | #ifndef AWT_ADVICE_HXX |
|---|
| 16 | #define AWT_ADVICE_HXX |
|---|
| 17 | |
|---|
| 18 | class AW_root; |
|---|
| 19 | |
|---|
| 20 | #ifndef AW_ROOT_HXX |
|---|
| 21 | #include <aw_root.hxx> |
|---|
| 22 | #endif |
|---|
| 23 | |
|---|
| 24 | |
|---|
| 25 | /// define type of @ref AWT_advice by or-ing values |
|---|
| 26 | enum AWT_Advice_Type { |
|---|
| 27 | AWT_ADVICE_SIMPLE = 0, // nothing of the following |
|---|
| 28 | AWT_ADVICE_TOGGLE = 1, // visible toggle to switch off advice (otherwise advice appears only once) |
|---|
| 29 | AWT_ADVICE_HELP = 2, // advice has corresponding help file |
|---|
| 30 | AWT_ADVICE_HELP_POPUP = 4, // this helpfile should popup immidiately |
|---|
| 31 | |
|---|
| 32 | } ; |
|---|
| 33 | |
|---|
| 34 | /// has to be called one time (before calling AWT_advice) |
|---|
| 35 | void init_Advisor(AW_root *awr, AW_default def); |
|---|
| 36 | |
|---|
| 37 | /** @brief Show a message box with an advice for the user |
|---|
| 38 | @param message the text shown to the user |
|---|
| 39 | @param title window title |
|---|
| 40 | @param type type of advice |
|---|
| 41 | @param corresponding_help name of corresponding ARB-helpfile |
|---|
| 42 | @see init_Advisor |
|---|
| 43 | */ |
|---|
| 44 | void AWT_advice(const char *message, |
|---|
| 45 | int type = AWT_ADVICE_SIMPLE, |
|---|
| 46 | const char *title = 0, |
|---|
| 47 | const char *corresponding_help = 0); |
|---|
| 48 | |
|---|
| 49 | /// reactivates all advices which were disabled by the user |
|---|
| 50 | void AWT_reactivate_all_advices(); |
|---|
| 51 | |
|---|
| 52 | |
|---|
| 53 | #else |
|---|
| 54 | #error awt_advice.hxx included twice |
|---|
| 55 | #endif // AWT_ADVICE_HXX |
|---|
