TGButtonGroup
class description - source file - inheritance tree
protected:
void Init()
public:
TGButtonGroup(TGWindow* parent, const TString& title, UInt_t options = kChildFrame|kVerticalFrame, GContext_t norm = GetDefaultGC()(), FontStruct_t font = GetDefaultFontStruct(), ULong_t back = GetDefaultFrameBackground())
TGButtonGroup(TGWindow* parent, UInt_t r, UInt_t c, Int_t s = 0, Int_t h = 0, const TString& title, GContext_t norm = GetDefaultGC()(), FontStruct_t font = GetDefaultFontStruct(), ULong_t back = GetDefaultFrameBackground())
TGButtonGroup(const TGButtonGroup&)
virtual ~TGButtonGroup()
void ButtonClicked()
void ButtonPressed()
void ButtonReleased()
static TClass* Class()
virtual void Clicked(Int_t id)
virtual void DrawBorder()
TGButton* Find(Int_t id) const
TGButton* GetButton(Int_t id) const
Int_t GetCount() const
Int_t GetId(TGButton* button) const
void Hide()
Int_t Insert(TGButton* button, int id = -1)
virtual TClass* IsA() const
Bool_t IsBorderDrawn() const
Bool_t IsExclusive() const
Bool_t IsRadioButtonExclusive() const
virtual void Pressed(Int_t id)
void ReleaseButtons()
virtual void Released(Int_t id)
void Remove(TGButton* button)
void SetBorderDrawn(Bool_t enable = kTRUE)
void SetButton(Int_t id, Bool_t down = kTRUE)
void SetExclusive(Bool_t flag = kTRUE)
void SetLayoutHints(TGLayoutHints* l, TGButton* button = 0)
void SetRadioButtonExclusive(Bool_t flag = kTRUE)
virtual void SetTitle(TGString* title)
virtual void SetTitle(const char* title)
void Show()
virtual void ShowMembers(TMemberInspector& insp, char* parent)
virtual void Streamer(TBuffer& b)
void StreamerNVirtual(TBuffer& b)
protected:
Bool_t fExclGroup kTRUE if group is exclusive
Bool_t fRadioExcl kTRUE if radio buttons are exclusive
Bool_t fDrawBorder kTRUE if border and title are drawn
TMap* fMapOfButtons map of button/id pairs in this group
See also
-
TGHButtonGroup, TGVButtonGroup
The TGButtonGroup widget organizes TGButton widgets in a group.
A button group widget makes it easier to deal with groups of buttons.
A button in a button group is associated with a unique identifier.
The button group emits a Clicked() signal with this identifier when
the button is clicked. Thus, a button group is an ideal solution
when you have several similar buttons and want to connect all their
Clicked() signals, for example, to one slot.
An exclusive button group switches off all toggle buttons except
the one that was clicked. A button group is by default non-exclusive.
All radio buttons that are inserted, will be mutually exclusive even
if the button group is non-exclusive.
There are two ways of using a button group:
The button group is a parent widget of a number of buttons,
i.e. the button group is the parent argument in the button
constructor. The buttons are assigned identifiers 1, 2, 3 etc.
/ in the order they are created or you can specify button id in
the button constructor. A TGButtonGroup can display a frame and
a title because it inherits from TGGroupFrame.
Example:
// vertical frame without border and title
TGVButtonGroup *bg = new TGVButtonGroup(main_frame);
// create text button with id=1
TGTextButton *button1 = new TGTextButton(bg,"some text");
// create another text button with id=2
TGTextButton *button2 = new TGTextButton(bg,"another text");
// map all buttons
bg->Show();
NOTE: there is no need to call AddFrame() since the buttons are
automatically added with a default layout hint to their parent,
i.e. the buttongroup. To override the default layout hints use the
SetLayoutHints() method.
ButtonGroup Signals:
Pressed(Int_t id) --> is emitted when a button in the group is
pressed down. The id argument is the
button's identifier.
Released(Int_t id) --> is emitted when a button in the group is
released. The id argument is the button's
identifier.
Clicked(Int_t id) --> is emitted when a button in the group is
clicked. The id argument is the button's
identifier.
The TGHButtonGroup widget organizes TGButton widgets in a group
with one horizontal row. TGHButtonGroup is a convenience class that
offers a thin layer on top of TGButtonGroup. It inherits from
TGButtonGroup.
The TGVButtonGroup widget organizes TGButton widgets in a group
with one vertical column. TGVButtonGroup is a convenience class that
offers a thin layer on top of TGButtonGroup. It inherits from
TGButtonGroup.
TGButtonGroup(TGWindow *parent,
const TString &title,
UInt_t options,
GContext_t norm,
FontStruct_t font,
ULong_t back) :
TGGroupFrame(parent, new TGString(title), options, norm, font, back)
Constructor. Layout 1 row or 1 column.
TGButtonGroup(TGWindow *parent,
UInt_t r, UInt_t c,
Int_t s, Int_t h,
const TString &title,
GContext_t norm ,
FontStruct_t font ,
ULong_t back) :
TGGroupFrame(parent, new TGString(title), 0, norm, font, back)
Constructor. Layout defined by TGMatrixLayout:
r = number of rows
c = number of columns
s = interval between frames
h = layout hints
void Init()
Default init.
~TGButtonGroup()
Destructor, we do not delete the buttons.
void SetBorderDrawn(Bool_t enable)
Makes border to be visible/invisible.
void SetExclusive(Bool_t enable)
Sets the button group to be exclusive if enable is kTRUE,
or to be non-exclusive if enable is kFALSE.
An exclusive button group switches off all other toggle buttons when
one is switched on. This is ideal for groups of radio-buttons
A non-exclusive group allow many buttons to be switched on at the same
time. The default setting is kFALSE.
void SetRadioButtonExclusive(Bool_t enable)
If enable is kTRUE, this button group will treat radio buttons as
mutually exclusive, and other buttons according to IsExclusive().
This function is called automatically whenever a TGRadioButton
is inserted, so you should normally never have to call it.
void SetButton(Int_t id, Bool_t down)
Sets the button with id to be on/down, and if this is an
exclusive group, all other button in the group to be off/up.
Int_t Insert(TGButton *button, Int_t id)
Inserts a button with the identifier id into the button group.
Returns the button identifier.
It is not necessary to manually insert buttons that have this button
group as their parent widget. An exception is when you want custom
identifiers instead of the default 1, 2, 3 etc.
The button is assigned the identifier id or an automatically
generated identifier. It works as follows: If id > 0, this
identifier is assigned. If id == -1 (default), the identifier is
equal to the number of buttons in the group+1. If id is any other
negative integer, for instance -2, a unique identifier (negative
integer <= -2) is generated.
Inserting several buttons with id = -1 assigns the identifiers 1,
2, 3, etc.
void Remove(TGButton *button)
Removes a button from the button group.
TGButton* Find(Int_t id) const
Finds and returns a pointer to the button with the specified
identifier id. Returns null if the button was not found.
Int_t GetId(TGButton *button) const
Finds and returns the id of the button.
Returns -1 if the button is not a member of this group.
void ButtonPressed()
This slot is activated when one of the buttons in the group emits the
Pressed() signal.
void ButtonReleased()
This slot is activated when one of the buttons in the group emits the
Released() signal.
void ButtonClicked()
This slot is activated when one of the buttons in the group emits the
Clicked() signal.
void ReleaseButtons()
This slot is activated when one of the buttons in the
exclusive group emits the Pressed() signal.
void Show()
Show group of buttons.
void Hide()
Hide group of buttons.
void SetTitle(TGString *title)
Set or change title.
void SetTitle(const char *title)
Set or change title.
void SetLayoutHints(TGLayoutHints *l, TGButton *button)
Set layout hints for the specified button or if button=0 for all
buttons.
Inline Functions
void Pressed(Int_t id)
void Released(Int_t id)
void Clicked(Int_t id)
Bool_t IsExclusive() const
Bool_t IsRadioButtonExclusive() const
Bool_t IsBorderDrawn() const
TGButton* GetButton(Int_t id) const
Int_t GetCount() const
void DrawBorder()
TClass* Class()
TClass* IsA() const
void ShowMembers(TMemberInspector& insp, char* parent)
void Streamer(TBuffer& b)
void StreamerNVirtual(TBuffer& b)
TGButtonGroup TGButtonGroup(const TGButtonGroup&)
Author: Valeriy Onuchin & Fons Rademakers 16/10/2000
Last update: root/gui:$Name: $:$Id: TGButtonGroup.cxx,v 1.13 2003/05/12 16:44:08 rdm Exp $
Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
ROOT page - Class index - Top of the page
This page has been automatically generated. If you have any comments or suggestions about the page layout send a mail to ROOT support, or contact the developers with any questions or problems regarding ROOT.