Geant4  10.02.p02
G4UIXm.hh
Go to the documentation of this file.
1 //
2 // ********************************************************************
3 // * License and Disclaimer *
4 // * *
5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. *
10 // * *
11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitation of liability. *
17 // * *
18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Software license. *
24 // ********************************************************************
25 //
26 //
27 // $Id: G4UIXm.hh 66892 2013-01-17 10:57:59Z gunter $
28 //
29 #ifndef G4UIXm_h
30 #define G4UIXm_h
31 
32 #if defined(G4UI_BUILD_XM_SESSION) || defined(G4UI_USE_XM)
33 
34 #include <map>
35 
36 #include <X11/Intrinsic.h>
37 
38 #include "G4VBasicShell.hh"
39 #include "G4VInteractiveSession.hh"
40 
41 class G4UIsession;
42 
43 // Class description :
44 //
45 // G4UIXm : class to handle a Motif interactive session.
46 // G4UIXm is the Motif version of G4UIterminal.
47 //
48 // A command box is at disposal for entering/recalling Geant4 commands.
49 // A menubar could be customized through the AddMenu, AddButton methods.
50 // Note that there are corresponding Geant4 commands to add a
51 // menus in the menubar and add buttons in a menu.
52 // Ex :
53 // /gui/addMenu test Test
54 // /gui/addButton test Init /run/initialize
55 // /gui/addButton test "Set gun" "/control/execute gun.g4m"
56 // /gui/addButton test "Run one event" "/run/beamOn 1"
57 //
58 // Command completion, by typing "tab" key, is available on the
59 // command line.
60 //
61 // Class description - end :
62 
63 class G4UIXm : public G4VBasicShell, public G4VInteractiveSession {
64 public: // With description
65  G4UIXm(int,char**);
66  // (argv, argc) or (0, NULL) had to be given.
68  // To enter interactive X loop ; waiting/executing command,...
69  void AddMenu(const char*,const char*);
70  // To add a pulldown menu in the menu bar.
71  // First argument is the name of the menu.
72  // Second argument is the label of the cascade button.
73  // Ex : AddMenu("my_menu","My menu")
74  void AddButton(const char*,const char*,const char*);
75  // To add a push button in a pulldown menu.
76  // First argument is the name of the menu.
77  // Second argument is the label of the button.
78  // Third argument is the Geant4 command executed when the button is fired.
79  // Ex : AddButton("my_menu","Run","/run/beamOn 1");
80 public:
81  ~G4UIXm();
82  void Prompt(G4String);
83  void SessionTerminate();
84  virtual void PauseSessionStart(const G4String&);
85  virtual G4int ReceiveG4cout(const G4String&);
86  virtual G4int ReceiveG4cerr(const G4String&);
87  G4String GetCommand(Widget);
88 private:
89  void SecondaryLoop(G4String);
91  void ExitHelp() const;
92 private:
93  Widget form,shell,command,menuBar,text;
94  std::map<Widget,G4String, std::less<Widget> > commands;
95  static void CommandEnteredCallback(Widget,XtPointer,XtPointer);
96  static void keyHandler(Widget,XtPointer,XEvent*,Boolean*);
97  G4bool fHelp;
98  G4int fHelpChoice;
99  static void ButtonCallback(Widget,XtPointer,XtPointer);
100 };
101 
102 #endif
103 
104 #endif
105 
virtual G4bool GetHelpChoice(G4int &)=0
virtual void ExitHelp() const =0
virtual G4int ReceiveG4cout(const G4String &coutString)
Definition: G4UIsession.cc:42
virtual void AddMenu(const char *, const char *)
int G4int
Definition: G4Types.hh:78
virtual void PauseSessionStart(const G4String &Prompt)=0
bool G4bool
Definition: G4Types.hh:79
virtual G4UIsession * SessionStart()=0
virtual void AddButton(const char *, const char *, const char *)
virtual G4int ReceiveG4cerr(const G4String &cerrString)
Definition: G4UIsession.cc:48