ShowToolButton
Syntax:
BOOL ShowToolButton(long nButton, BOOL
bShow);
Return
Value: TRUE if the
operation was successful, otherwise FALSE.
Parameters:
nButton Specifies the ELS-QB component’s toolbar button combination and may be any of
the following values:
QB_CONNPANE_BTN = 1
QB_DVWPANE_BTN =
2
QB_RELPANE_BTN =
3
QB_COLPANE_BTN =
4
QB_SQLPANE_BTN =
5
QB_CHKSQL_BTN =
6
QB_EXECUTE_BTN =
7
QB_STOP_BTN
= 8
QB_ALL_BTNS
= 9
bShow
Specifies the further visibility of the selected button
combination.
Remarks:
Call
this method to show / hide the specific button combination in the ELS-QB
control’s toolbar (the toolbar located on left side of the Connection
pane). Note that the QB_ALL_BTNS combination will show / hide the toolbar
itself.This
method may be used to hide or deactivate a certain functionality of the ELS-QB
for either security or simplification purpose. For example, the developer may
want to hide the Connection pane and
the toolbar button corresponding to the toggling of show/hide of this pane (e.g.
QB_CONNPANE_BTN). In this way the end-user may not have access to the Connection pane of the ELS-QB
control.
Note:
If this method is never called, all
toolbar buttons are shown by default.
Example:
This
sample code shows how to allow the end user to toggle in view a specifiedbutton
of
ELS-QB control’s toolbar.
void
CELS_QBDemoView::CELS_QBDemoView ()
{
............................
............................
m_bRelPaneBtnVisible
= TRUE;
}
//
Some command handler
void
CELS_QBDemoView::OnCommandToggleRelPaneBtnInView()
{
if(m_QBCtrl.ShowToolButton(QB_RELPANE_BTN,!m_bRelPaneBtnVisible))
m_bRelPaneBtnVisible
= ! m_bRelPaneBtnVisible;
}