~ubuntu-branches/debian/sid/ncurses/sid-200908151543

1 by Daniel Jacobowitz
Import upstream version 5.2.20020112a
1
// * This makes emacs happy -*-Mode: C++;-*-
2
/****************************************************************************
3
 * Copyright (c) 1998,2000 Free Software Foundation, Inc.                   *
4
 *                                                                          *
5
 * Permission is hereby granted, free of charge, to any person obtaining a  *
6
 * copy of this software and associated documentation files (the            *
7
 * "Software"), to deal in the Software without restriction, including      *
8
 * without limitation the rights to use, copy, modify, merge, publish,      *
9
 * distribute, distribute with modifications, sublicense, and/or sell       *
10
 * copies of the Software, and to permit persons to whom the Software is    *
11
 * furnished to do so, subject to the following conditions:                 *
12
 *                                                                          *
13
 * The above copyright notice and this permission notice shall be included  *
14
 * in all copies or substantial portions of the Software.                   *
15
 *                                                                          *
16
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
17
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
18
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
19
 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
20
 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
21
 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
22
 * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
23
 *                                                                          *
24
 * Except as contained in this notice, the name(s) of the above copyright   *
25
 * holders shall not be used in advertising or otherwise to promote the     *
26
 * sale, use or other dealings in this Software without prior written       *
27
 * authorization.                                                           *
28
 ****************************************************************************/
29
30
/****************************************************************************
31
 *   Author: Juergen Pfeifer <juergen.pfeifer@gmx.net> 1997                 *
32
 ****************************************************************************/
33
34
// $Id: cursesapp.h,v 1.7 2001/03/24 21:41:18 tom Exp $
35
36
#ifndef NCURSES_CURSESAPP_H_incl
37
#define NCURSES_CURSESAPP_H_incl
38
39
#include <cursslk.h>
40
41
class NCURSES_IMPEXP NCursesApplication {
42
public:
43
  typedef struct _slk_link {          // This structure is used to maintain
44
    struct _slk_link* prev;           // a stack of SLKs
45
    Soft_Label_Key_Set* SLKs;
46
  } SLK_Link;
47
private:
48
  static int rinit(NCursesWindow& w); // Internal Init function for title
49
  static NCursesApplication* theApp;  // Global ref. to the application
50
51
  static SLK_Link* slk_stack;
52
53
protected:
54
  static NCursesWindow* titleWindow;  // The Title Window (if any)
55
56
  bool b_Colors;                      // Is this a color application?
57
  NCursesWindow* Root_Window;         // This is the stdscr equiv.
58
59
  // Initialization of attributes;
60
  // Rewrite this in your derived class if you prefer other settings
61
  virtual void init(bool bColors);
62
63
  // The number of lines for the title window. Default is no title window
64
  // You may rewrite this in your derived class
65
  virtual int titlesize() const {
66
    return 0;
67
  }
68
69
  // This method is called to put something into the title window initially
70
  // You may rewrite this in your derived class
71
  virtual void title() {
72
  }
73
74
  // The layout used for the Soft Label Keys. Default is to have no SLKs.
75
  // You may rewrite this in your derived class
76
  virtual Soft_Label_Key_Set::Label_Layout useSLKs() const {
77
    return Soft_Label_Key_Set::None;
78
  }
79
80
  // This method is called to initialize the SLKs. Default is nothing.
81
  // You may rewrite this in your derived class
82
  virtual void init_labels(Soft_Label_Key_Set& S) const {
83
  }
84
85
  // Your derived class must implement this method. The return value must
86
  // be the exit value of your application.
87
  virtual int run() = 0;
88
89
90
  // The constructor is protected, so you may use it in your derived
91
  // class constructor. The argument tells whether or not you want colors.
92
  NCursesApplication(bool wantColors = FALSE);
93
94
public:
95
  virtual ~NCursesApplication();
96
97
  // Get a pointer to the current application object
98
  static NCursesApplication* getApplication() {
99
    return theApp;
100
  }
101
102
  // This method runs the application and returns its exit value
103
  int operator()(void);
104
105
  // Process the commandline arguments. The default implementation simply
106
  // ignores them. Your derived class may rewrite this.
107
  virtual void handleArgs(int argc, char* argv[]) {
108
  }
109
110
  // Does this application use colors?
111
  inline bool useColors() const {
112
    return b_Colors;
113
  }
114
115
  // Push the Key Set S onto the SLK Stack. S then becomes the current set
116
  // of Soft Labelled Keys.
117
  void push(Soft_Label_Key_Set& S);
118
119
  // Throw away the current set of SLKs and make the previous one the
120
  // new current set.
121
  bool pop();
122
123
  // Retrieve the current set of Soft Labelled Keys.
124
  Soft_Label_Key_Set* top() const;
125
126
  // Attributes to use for menu and forms foregrounds
127
  virtual chtype foregrounds() const {
128
    return b_Colors ? COLOR_PAIR(1) : A_BOLD;
129
  }
130
131
  // Attributes to use for menu and forms backgrounds
132
  virtual chtype backgrounds() const {
133
    return b_Colors ? COLOR_PAIR(2) : A_NORMAL;
134
  }
135
136
  // Attributes to use for inactive (menu) elements
137
  virtual chtype inactives() const {
138
    return b_Colors ? (COLOR_PAIR(3)|A_DIM) : A_DIM;
139
  }
140
141
  // Attributes to use for (form) labels and SLKs
142
  virtual chtype labels() const {
143
    return b_Colors ? COLOR_PAIR(4) : A_NORMAL;
144
  }
145
146
  // Attributes to use for form backgrounds
147
  virtual chtype dialog_backgrounds() const {
148
    return b_Colors ? COLOR_PAIR(4) : A_NORMAL;
149
  }
150
151
  // Attributes to use as default for (form) window backgrounds
152
  virtual chtype window_backgrounds() const {
153
    return b_Colors ? COLOR_PAIR(5) : A_NORMAL;
154
  }
155
156
  // Attributes to use for the title window
157
  virtual chtype screen_titles() const {
158
    return b_Colors ? COLOR_PAIR(6) : A_BOLD;
159
  }
160
161
};
162
 
163
#endif // NCURSES_CURSESAPP_H_incl