class TGMenuBar: public TGHorizontalFrame
TGMenuBar, TGPopupMenu, TGMenuTitle and TGMenuEntry The TGMenu.h header contains all different menu classes. The TGMenuBar class implements a menu bar widget. It is used to specify and provide access to common and frequently used application actions grouped under menu titles (TGMenuTitle class). The menu bar takes the highest-level of the menu system and it is a starting point for many interactions. It is always visible and allows using the keyboard equivalents. The geometry of the menu bar is automatically set to the parent widget, i.e. the menu bar automatically resizes itself so that it has the same width as its parent (typically TGMainFrame). A menu bar contains one or more popup menus and usually is placed along the top of the application window. Any popup menu is invisible until the user invokes it by using the mouse pointer or the keyboard. Popup menus implemented by TGPopupMenu class are unique in that, by convention, they are not placed with the other GUI components in the user interfaces. Instead, a popup menu usually appears either in a menu bar or as a context menu on the TOP of the GUI. For that reason it needs gClient->GetDefaultRoot() as a parent to get the pointer to the root (i.e. desktop) window. This way a popup menu will never be embedded. NOTE: Using gClient->GetRoot() as a parent of TGPopupMenu will not avoid the possibility of embedding the corresponding popup menu because the current window hierarchy can be changed by using gClient->SetRoot() method. As a context menus TGPopupMenu shows up after pressing the right mouse button, over a popup-enabled component. The popup menu then appears under the mouse pointer. Selecting a menu item will generate the event: kC_COMMAND, kCM_MENU, menu id, user data.
Function Members (Methods)
public:
protected:
| virtual void | AddFrameBefore(TGFrame* f, TGLayoutHints* l = 0, TGPopupMenu* before = 0) |
| virtual void | BindHotKey(Int_t keycode, Bool_t on = kTRUE) |
| virtual void | BindKeys(Bool_t on = kTRUE) |
| void | BindMenu(TGPopupMenu* subMenu, Bool_t on) |
| static Int_t | TQObject::CheckConnectArgs(TQObject* sender, TClass* sender_class, const char* signal, TClass* receiver_class, const char* slot) |
| static Bool_t | TQObject::ConnectToClass(TQObject* sender, const char* signal, TClass* receiver_class, void* receiver, const char* slot) |
| static Bool_t | TQObject::ConnectToClass(const char* sender_class, const char* signal, TClass* receiver_class, void* receiver, const char* slot) |
| virtual void | TObject::DoError(int level, const char* location, const char* fmt, va_list va) const |
| virtual void | TGFrame::DoRedraw() |
| virtual void | TGFrame::Draw3dRectangle(UInt_t type, Int_t x, Int_t y, UInt_t w, UInt_t h) |
| static Time_t | TGFrame::GetLastClick() |
| TString | TGFrame::GetOptionString() const |
| const TGResourcePool* | TGFrame::GetResourcePool() const |
| virtual void* | TGFrame::GetSender() |
| virtual const char* | TQObject::GetSenderClassName() const |
| void | TObject::MakeZombie() |
| virtual void | TGFrame::StartGuiBuilding(Bool_t on = kTRUE) |
Data Members
public:
| enum TGFrame::[unnamed] { | kDeleteWindowCalled | |
| }; | ||
| enum TGWindow::EEditMode { | kEditEnable | |
| kEditDisable | ||
| kEditDisableEvents | ||
| kEditDisableGrab | ||
| kEditDisableLayout | ||
| kEditDisableResize | ||
| kEditDisableHeight | ||
| kEditDisableWidth | ||
| kEditDisableBtnEnable | ||
| kEditDisableKeyEnable | ||
| }; | ||
| enum TObject::EStatusBits { | kCanDelete | |
| kMustCleanup | ||
| kObjInCanvas | ||
| kIsReferenced | ||
| kHasUUID | ||
| kCannotPick | ||
| kNoContextMenu | ||
| kInvalidObject | ||
| }; | ||
| enum TObject::[unnamed] { | kIsOnHeap | |
| kNotDeleted | ||
| kZombie | ||
| kBitMask | ||
| kSingleKey | ||
| kOverwrite | ||
| kWriteDelete | ||
| }; |
protected:
| Pixel_t | TGFrame::fBackground | frame background color |
| Int_t | TGFrame::fBorderWidth | frame border width |
| TGClient* | TGObject::fClient | Connection to display server |
| TGMenuTitle* | fCurrent | current menu title |
| Int_t | TGFrame::fDNDState | EDNDFlags |
| Cursor_t | fDefaultCursor | right pointing cursor |
| UInt_t | TGWindow::fEditDisabled | flags used for "guibuilding" |
| UInt_t | TGFrame::fEventMask | currenty active event mask |
| TGFrameElement* | TGFrame::fFE | pointer to frame element |
| UInt_t | TGFrame::fHeight | frame height |
| Handle_t | TGObject::fId | X11/Win32 Window identifier |
| Bool_t | fKeyNavigate | kTRUE if arrow key navigation is on |
| Bool_t | TGCompositeFrame::fLayoutBroken | no layout manager is used |
| TGLayoutManager* | TGCompositeFrame::fLayoutManager | layout manager |
| TList* | TGCompositeFrame::fList | container of frame elements |
| TList* | TQObject::fListOfConnections | ! list of connections to this object |
| TList* | TQObject::fListOfSignals | ! list of signals from this object |
| Bool_t | TGCompositeFrame::fMapSubwindows | kTRUE - map subwindows |
| UInt_t | TGFrame::fMaxHeight | maximal frame height |
| UInt_t | TGFrame::fMaxWidth | maximal frame width |
| TGLayoutHints* | fMenuBarMoreLayout | layout of the extra menu |
| TGPopupMenu* | fMenuMore | extra >> menu |
| UInt_t | TGFrame::fMinHeight | minimal frame height |
| UInt_t | TGFrame::fMinWidth | minimal frame width |
| Int_t | TGCompositeFrame::fMustCleanup | cleanup mode (see EFrameCleanup) |
| TString | TGWindow::fName | name of the window used in SavePrimitive() |
| Bool_t | TGWindow::fNeedRedraw | kTRUE if window needs to be redrawn |
| TList* | fNeededSpace | keeps trace of space needed for hidden menus |
| UInt_t | TGFrame::fOptions | frame options |
| TList* | fOutLayouts | keeps trace of layouts of hidden menus |
| const TGWindow* | TGWindow::fParent | Parent window |
| Bool_t | TQObject::fSignalsBlocked | ! flag used for suppression of signals |
| Bool_t | fStick | stick mode (popup menu stays sticked on screen) |
| TList* | fTitles | list of menu titles |
| TList* | fTrash | garbage |
| UInt_t | TGFrame::fWidth | frame width |
| Bool_t | fWithExt | indicates whether the >> menu is shown or not |
| Int_t | TGFrame::fX | frame x position |
| Int_t | TGFrame::fY | frame y position |
| static Bool_t | TQObject::fgAllSignalsBlocked | flag used for suppression of all signals |
| static const TGGC* | TGFrame::fgBckgndGC | |
| static const TGGC* | TGFrame::fgBlackGC | |
| static Pixel_t | TGFrame::fgBlackPixel | |
| static Int_t | TGWindow::fgCounter | counter of created windows in SavePrimitive |
| static Window_t | TGFrame::fgDbw | |
| static Int_t | TGFrame::fgDbx | |
| static Int_t | TGFrame::fgDby | |
| static Pixel_t | TGFrame::fgDefaultFrameBackground | |
| static TGLayoutHints* | TGCompositeFrame::fgDefaultHints | default hints used by AddFrame() |
| static Pixel_t | TGFrame::fgDefaultSelectedBackground | |
| static const TGGC* | TGFrame::fgHilightGC | |
| static Bool_t | TGFrame::fgInit | |
| static UInt_t | TGFrame::fgLastButton | |
| static Time_t | TGFrame::fgLastClick | |
| static const TGGC* | TGFrame::fgShadowGC | |
| static UInt_t | TGFrame::fgUserColor | |
| static const TGGC* | TGFrame::fgWhiteGC | |
| static Pixel_t | TGFrame::fgWhitePixel |
Class Charts
Function documentation
TGMenuBar(const TGWindow* p = 0, UInt_t w = 60, UInt_t h = 20, UInt_t options = kHorizontalFrame|kRaisedFrame)
Create a menu bar object.
~TGMenuBar()
Delete menu bar object. Removes also the hot keys from the main frame, so hitting them will not cause the menus to popup.
TGFrameElement* GetLastOnLeft()
Returns the last visible menu title on the left of the '>>' in the menu bar.
void PopupConnection()
Connects the corresponding cascaded menu to the proper slots, according to the highlighted menu entry in '>>' menu.
void BindKeys(Bool_t on = kTRUE)
If on kTRUE bind arrow, popup menu hot keys, otherwise remove key bindings.
void BindMenu(TGPopupMenu* subMenu, Bool_t on)
If on kTRUE bind subMenu hot keys, otherwise remove key bindings.
void BindHotKey(Int_t keycode, Bool_t on = kTRUE)
If on kTRUE bind hot keys, otherwise remove key binding.
void AddPopup(TGHotString* s, TGPopupMenu* menu, TGLayoutHints* l, TGPopupMenu* before = 0)
Add popup menu to menu bar. The hot string will be adopted by the menubar (actually the menu title) and deleted when possible. If before is not 0 the menu will be added before it.
void AddTitle(TGMenuTitle* title, TGLayoutHints* l, TGPopupMenu* before = 0)
Add popup via created before menu title.
void AddPopup(const char* s, TGPopupMenu* menu, TGLayoutHints* l, TGPopupMenu* before = 0)
Add popup menu to menu bar. If before is not 0 the menu will be added before it.
TGPopupMenu * AddPopup(const TString& s, Int_t padleft = 4, Int_t padright = 0, Int_t padtop = 0, Int_t padbottom = 0)
Add popup menu to menu bar.
Comment:
This method is valid only for horizontal menu bars.
The most common case is menu bar containing equidistant titles padding left side.
TGMenuBar *bar;
bar->AddPopup("title1", 10);
bar->AddPopup("title2", 10);
To add equidistant titles padding right side padleft must be 0.
TGMenuBar *bar;
bar->AddPopup("title1", 0, 10);
bar->AddPopup("title2", 0, 10);
This method guarantee automatic cleanup when menu bar is destroyed.
Do not delete returned popup-menu
void AddFrameBefore(TGFrame* f, TGLayoutHints* l = 0, TGPopupMenu* before = 0)
Private version of AddFrame for menubar, to make sure that we indeed only add TGMenuTitle objects to it. If before is not 0 the menu will be added before it.
TGPopupMenu * GetPopup(const char* s)
Return popup menu with the specified name. Returns 0 if menu is not found. Returnes menu can be used as "before" in AddPopup(). Don't use hot key (&) in name.
TGPopupMenu * RemovePopup(const char* s)
Remove popup menu from menu bar. Returned menu has to be deleted by the user, or can be re-used in another AddPopup(). Returns 0 if menu is not found. Don't use hot key (&) in name.
void SavePrimitive(ostream& out, Option_t* option = "")
Save a menu bar widget as a C++ statement(s) on output stream out.
TGMenuEntry& operator=(const TGMenuBar& )