BBjWindow

Creation Path

+--BBjWindow

Description

A BBjWindow is an object that provides an interface to a GUI window. Graphical controls and child windows can be added to a BBjWindow.

Implemented Interfaces

DropTarget

Creation

BBjWindow objects are created by creating either a BBjTopLevelWindow or a BBjChildWindow.

Methods of BBjWindow

Return Value	Method
BBjBarChart	addBarChart(int controlID, int left, int top, int width, int height, string xLabel, string yLabel, int seriesCount, int categoryCount, boolean showLegend, boolean is3D, boolean isHorizontal)
BBjBarChart	addBarChart(int controlID, int left, int top, int width, int height, string xLabel, string yLabel, int seriesCount, int categoryCount, boolean showLegend, boolean is3D, boolean isHorizontal, string flags)
BBjButton	addButton(int ID, int x, int y, int width, int height, string title)
BBjButton	addButton(int ID, int x, int y, int width, int height, string title, string flags)
BBjCEdit	addCEdit(int ID, int x, int y, int width, int height, string title)
BBjCEdit	addCEdit(int ID, int x, int y, int width, int height, string title, string flags)
BBjCheckBox	addCheckBox(int ID, int x, int y, int width, int height, string title)
BBjCheckBox	addCheckBox(int ID, int x, int y, int width, int height, string title, string flags)
BBjChildWindow	addChildWindow(int ID, int x, int y, int w, int h, int context)
BBjChildWindow	addChildWindow(int ID, int x, int y, int w, int h, string title, int context)
BBjChildWindow	addChildWindow(int ID, int x, int y, int w, int h, string title, string flags, int context)
BBjChildWindow	addChildWindow(int ID, int x, int y, int w, int h, string title, string flags, int context, string eventMask)
BBjColorChooser	addColorChooser(int ID, int x, int y, int width, int height)
BBjColorChooser	addColorChooser(int ID, int x, int y, int width, int height, BBjColor selected)
BBjColorChooser	addColorChooser(int ID, int x, int y, int width, int height, BBjColor selected, string flags)
BBjDataAwareGrid	addDataAwareGrid(int ID, int x, int y, int width, int height, int channel, string template)
BBjDataAwareGrid	addDataAwareGrid(int ID, int x, int y, int width, int height, string flags, int channel, string template)
BBjDataAwareGrid	addDataAwareGrid(int ID, int rowID, int colID, int x, int y, int width, int height, int channel, string template)
BBjDataAwareGrid	addDataAwareGrid(int ID, int rowID, int colID, int x, int y, int width, int height, string flags, int channel, string template)
BBjDataBoundGrid	addDataBoundGrid(int ID, int x, int y, int width, int height)
BBjDataBoundGrid	addDataBoundGrid(int ID, int x, int y, int width, int height, string flags)
BBjEditBox	addEditBox(int ID, int x, int y, int width, int height, string title)
BBjEditBox	addEditBox(int ID, int x, int y, int width, int height, string title, string flags)
BBjEditBoxSpinner	addEditBoxSpinner(int ID, int x, int y, int width, int height, string text$)
BBjEditBoxSpinner	addEditBoxSpinner(int ID, int x, int y, int width, int height, string text$, string flags$)
BBjEditBoxSpinner	addEditBoxSpinner(int ID, int x, int y, int width, int height, BBjVector list!)
BBjEditBoxSpinner	addEditBoxSpinner(int ID, int x, int y, int width, int height, BBjVector list!, string flags$)
BBjFileChooser	addFileChooser(int ID, int x, int y, int width, int height, string directory)
BBjFileChooser	addFileChooser(int ID, int x, int y, int width, int height, string directory, string flags)
BBjFontChooser	addFontChooser(int ID, int x, int y, int width, int height)
BBjFontChooser	addFontChooser(int ID, int x, int y, int width, int height, BBjFont font)
BBjFontChooser	addFontChooser(int ID, int x, int y, int width, int height, BBjFont font, string flags)
BBjGenericChart	addGenericChart(int controlID, int left, int top, int width, int height)
BBjGenericChart	addGenericChart(int controlID, int left, int top, int width, int height, string flags)
BBjGrid	addGrid(int ID, int x, int y, int width, int height)
BBjGrid	addGrid(int ID, int x, int y, int width, int height, string flags)
BBjGrid	addGrid(int ID, int x, int y, int width, int height, string flags, int rows, int columns)
BBjGrid	addGrid(int ID, int rowID, int colID, int x, int y, int width, int height)
BBjGrid	addGrid(int ID, int rowID, int colID, int x, int y, int width, int height, string flags)
BBjGrid	addGrid(int ID, int rowID, int colID, int x, int y, int width, int height, string flags, int rows, int columns)
BBjGroupBox	addGroupBox(int ID, int x, int y, int width, int height, string title)
BBjGroupBox	addGroupBox(int ID, int x, int y, int width, int height, string title, string flags)
BBjScrollBar	addHorizontalScrollBar int ID, int x,int y, int width, int height, string flags)
BBjScrollBar	addHorizontalScrollBar(int ID, int x,int y, int width, int height)
BBjSlider	addHorizontalSlider(int ID, int x, int y, int width, int height)
BBjSlider	addHorizontalSlider(int ID, int x, int y, int width, int height, string flags)
BBjHtmlView	addHtmlView(int ID, int x, int y, int width, int height, string title, string flags)
BBjImageCtrl	addImage(int ID, int x, int y, int width, int height, string filename) – deprecated, use addImageCtrl
BBjImageCtrl	addImageCtrl(int ID, int x, int y, int width, int height, BBjImage image)
BBjImageCtrl	addImageCtrl(int ID, int x, int y, int width, int height, string filename)
BBjInputD	addInputD(int ID, int x, int y, int w, int h)
BBjInputD	addInputD(int ID, int x, int y, int w, int h, string flags)
BBjInputD	addInputD(int ID, int x, int y, int w, int h, string flags, string mask)
BBjInputD	addInputD(int ID, int x, int y, int w, int h, string flags, string mask, string rules)
BBjInputD	addInputD(int ID, int x, int y, int w, int h, string flags, string mask, string rules, int restore)
BBjInputD	addInputD(int ID, int x, int y, int w, int h, string flags, string mask, string rules, int restore, int value)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, int min, int max)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, int min, int max)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, int min, int max)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$, int restore, int value)
BBjInputDSpinner	addInputDSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$, int restore, int value, int min, int max)
BBjInputE	addInputE(int ID, int x, int y, int w, int h)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, int len)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, int len, string pad)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, int len, string pad, string val)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, int len, string pad, int initPos, string restore, string val)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, string mask)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, string mask, string pad)
BBjInputE	addInputE(int ID, int x, int y, int w, int h, string flags, string mask, string pad,string val)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$, string val$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$, string val$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$, int initPos, string restore$, string val$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, int len, string pad$, int initPos, string restore$, string val$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$, string val$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$, string val$, BBjVector list!)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$, int initPos, string restore$, string val$)
BBjInputESpinner	addInputESpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string pad$, int initPos, string restore$, string val$, BBjVector list!)
BBjInputN	addInputN(int ID, int x, int y, int w, int h)
BBjInputN	addInputN(int ID, int x, int y, int w, int h, string flags)
BBjInputN	addInputN(int ID, int x, int y, int w, int h, string flags, string mask)
BBjInputN	addInputN(int ID, int x, int y, int w, int h, string flags, string mask, string rules)
BBjInputN	addInputN(int ID, int x, int y, int w, int h, string flags, string mask, string rules, int restore, int value)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, int min, int max)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, int min, int max)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, int min, int max)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$, int restore, int value)
BBjInputNSpinner	addInputNSpinner(int ID, int x, int y, int w, int h, string flags$, string mask$, string rules$, int restore, int value, int min, int max)
BBjLineChart	addLineChart(int controlID, int left, int top, int width, int height, string xLabel, string yLabel, int numSeries, boolean showLegend)
BBjLineChart	addLineChart(int controlID, int left, int top, int width, int height, string xLabel, string yLabel, int numSeries, boolean showLegend, string flags)
BBjListBox	addListBox(int ID, int x, int y, int width, int height, string title)
BBjListBox	addListBox(int ID, int x, int y, int width, int height, string title, string flags)
BBjListButton	addListButton(int ID, int x, int y, int width, int height, string title)
BBjListButton	addListButton(int ID, int x, int y, int width, int height, string title, string flags)
BBjListEdit	addListEdit(int ID, int x, int y, int width, int height, string title)
BBjListEdit	addListEdit(int ID, int x, int y, int width, int height, string title, string flags)
BBjMenuButton	addMenuButton(int ID, int x, int y, int width, int height, string title)
BBjMenuButton	addMenuButton(int ID, int x, int y, int width, int height, string title), string flags)
BBjNavigator	addNavigator(int ID, int x, int y, int width, int height, string title)
BBjNavigator	addNavigator(int ID, int x, int y, int width, int height, string title, string flags)
BBjPieChart	addPieChart(int controlID, int left, int top, int width, int height, boolean showLegend, boolean is3D)
BBjPieChart	addPieChart(int controlID, int left, int top, int width, int height, boolean showLegend, boolean is3D, string flags)
BBjProgressBar	addProgressBar(int ID, int x, int y, int width, int height)
BBjProgressBar	addProgressBar(int ID, int x, int y, int width, int height, int minimum, int maximum)
BBjProgressBar	addProgressBar(int ID, int x, int y, int width, int height, int orientation)
BBjProgressBar	addProgressBar(int ID, int x, int y, int width, int height, int orientation, int minimum, int maximum)
BBjPrintPreview	addPrintPreview(int ID, int x, int y, int width, int height, string flags)
BBjRadioButton	addRadioButton(int ID, int x,int y, int width, int height, string title)
BBjRadioButton	addRadioButton(int ID, int x,int y, int width, int height, string title, string flags)
BBjRadioGroup	addRadioGroup()
BBjRadioGroup	addRadioGroup(BBjVector radiobutton)
BBjSlider	addVerticalSlider(int ID, int x,int y, int width, int height)
BBjSlider	addVerticalSlider(int ID, int x,int y, int width, int height, string flags)
BBjStaticText	addStaticText(int ID, int x,int y, int width, int height, string title)
BBjStaticText	addStaticText(int ID, int x,int y, int width, int height, string title, string flags)
BBjStatusBar	addStatusBar(int ID)
BBjStatusBar	addStatusBar(int ID, string flags)
BBjTabCtrl	addTabCtrl(int ID, int x, int y, int w, int h)
BBjTabCtrl	addTabCtrl(int ID, int x, int y, int w, int h, string flags)
BBjTabCtrl	addTabCtrl(int ID, int x, int y, int w, int h, string flags,string styles)
BBjTabCtrl	addTabCtrl(int ID, int x, int y, int w, int h, string flags,string styles, string tabDesc)
BBjTabCtrl	addTabCtrl(int ID, int x, int y, int w, int h, string flags,string styles, string tabDesc,int imageList)
BBjToolButton	addToolButton(int ID, int x, int y, int width, int height, string title)
BBjToolButton	addToolButton(int ID, int x, int y, int width, int height, string title, string flags)
BBjTree	addTree(int ID, int x, int y, int width, int height)
BBjTree	addTree(int ID, int x, int y, int width, int height, string title, string flags)
BBjScrollBar	addVerticalScrollBar(int ID, int x, int y, int width, int height)
BBjScrollBar	addVerticalScrollBar(int ID, int x, int y, int width, int height, string flags)
BBjSlider	addVerticalSlider(int ID, int x, int y, int width, int height)
BBjSlider	addVerticalSlider(int ID, int x, int y, int width, int height, string flags)
BBjWrappedJComponent	addWrappedJComponent(int ID, int x, int y, int w, int h, ClientObject jComponent)
BBjChildWindow	createChildWindow(int resHandle, int childWindowID, int controlID, int x, int y)
BBjChildWindow	createChildWindow(int resHandle, int childWindowID, int controlID, int x, int y, int context)
BBjVector	getAllControls()
int	getAvailableControlID()
BBjChildWindow	getChildWindow(int id)
BBjControl	getControl(int id)
BBjControl	getControl(string name)
BBjControl	getFocusedControl()
int	getFocusedControlID()
void	setCursor(string filename)
void	setCursor(int cursorid)
void	setIcon(string filename)
void	setIcon(string filename, int index)
void	setTrack(boolean track)

Methods of BBjWindow implemented for DropTarget

Return Value	Method
int	getDropActions()
BBjVector	getDropTypes()
void	setDropActions(int actions)
void	setDropType(BBjVector types)

Methods of BBjWindow inherited from BBjControl

Convenience Methods of BBjWindow

In BBj 6.0 and higher, BBjWindow provides convenience methods listed in the table below. Each of these method calls getControl(int controlID) and casts the returned value to a specific control type. Convenience methods can be used to avoid using the CAST() Function if the developer knows the type of a control.

In BBj 11.0 and higher, these methods take (String name).

Return Value	Method
BBjButton	getButton(int ID)
BBjButton	getButton(String name)
BBjCEdit	getCEdit(int ID)
BBjCEdit	getCEdit(String name)
BBjGroupBox	getGroupBox(int ID)
BBjGroupBox	getGroupBox(String name)
BBjHtmlView	getHtmlView(int ID)
BBjHtmlView	getHtmlView(String name)
BBjImageCtrl	getImageCtrl(int ID)
BBjImageCtrl	getImageCtrl(String name)
BBjInputD	getInputD(int ID)
BBjInputD	getInputD(String name)
BBjInputE	getInputE(int ID)
BBjInputE	getInputE(String name)
BBjInputN	getInputN(int ID)
BBjInputN	getInputN(String name)
BBjListBox	getListBox (int ID)
BBjListBox	getListBox (String name)
BBjListButton	getListButton(int ID)
BBjListButton	getListButton(String name)
BBjListEdit	getListEdit(int ID)
BBjListEdit	getListEdit(String name)
BBjMenu	getMenu(int ID)
BBjMenu	getMenu(String name)
BBjMenuBar	getMenuBar(int ID)
BBjMenuBar	getMenuBar(String name)
BBjMenuItem	getMenuItem(int ID)
BBjMenuItem	getMenuItem(String name)
BBjNavigator	getNavigator(int ID)
BBjNavigator	getNavigator(String name)
BBjProgressBar	getProgressBar(int ID)
BBjProgressBar	getProgressBar(String name)
BBjRadioButton	getRadioButton(int ID)
BBjRadioButton	getRadioButton(String name)
BBjRadioGroup	getRadioGroup(int ID)
BBjRadioGroup	getRadioGroup(String name)
BBjScrollBar	getScrollBar(int ID)
BBjScrollBar	getScrollBar(String name)
BBjStandardGrid	getStandardGrid(int ID)
BBjStandardGrid	getStandardGrid(String name)
BBjStaticText	getStaticText(int ID)
BBjStaticText	getStaticText(String name)
BBjStatusBar	getStatusBar(int ID)
BBjStatusBar	getStatusBar(String name)
BBjTabCtrl	getTabCtrl(int ID)
BBjTabCtrl	getTabCtrl(String name)
BBjToolButton	getToolButton(int ID)
BBjToolButton	getToolButton(String name)
BBjTree	getTree (int ID)
BBjTree	getTree (String name)

Events

Callback Code	Object-oriented Event	Read Record Event	Code
ON_ACTIVATE	BBjActivateEvent	Activation	A
ON_CLOSE	BBjCloseEvent	Window Close Box	X
ON_COLOR_CHANGE	BBjColorChangeEvent	System Color Change Event	s
ON_DEACTIVATE	BBjDeactivateEvent	Activation	A
ON_DOUBLE_CLICK	BBjDoubleClickEvent	Mouse Double-Click	2
ON_KEYPRESS	BBjKeypressEvent	Keypress	t
ON_MINIMIZE	BBjMinimizeEvent	Activation	A
ON_MOUSE_DOWN	BBjMouseDownEvent	Mouse Button Down	d
ON_MOUSE_ENTER	BBjMouseEnterEvent	Mouse Enter/Exit Event	E
ON_MOUSE_EXIT	BBjMouseExitEvent	Mouse Enter/Exit Event	E
ON_MOUSE_MOVE	BBjMouseMoveEvent	Mouse Move	m
ON_MOUSE_SCROLL	BBjScrollWheelEvent	Mouse Scroll Wheel	w
ON_MOUSE_UP	BBjMouseUpEvent	Mouse Button Up	u
ON_RESIZE	BBjResizeEvent	Window Resize	S
ON_RESTORE	BBjRestoreEvent	Activation	A
ON_RIGHT_MOUSE_DOWN	BBjRightMouseDownEvent	Right Mouse Button Down Event	R
ON_SCREEN_RESIZE	BBjScreenResizeEvent	Screen Resize Event	s
ON_WINDOW_MOVE	BBjWindowMoveEvent	Window Move	L
ON_WINDOW_SCROLL	BBjWindowScrollEvent	Scrollbar Move	p
ON_WINDOW_GAINED_FOCUS	BBjWindowGainedFocusEvent	Window Focus Gained/Lost Event	F
ON_WINDOW_LOST_FOCUS	BBjWindowLostFocusEvent	Window Focus Gained/Lost Event	F

Remarks

All BBjControl objects are created via a window object. Except for the tree, all controls created with object syntax can also be manipulated with mnemonics and sendmsgs. They are identical to the controls created with mnemonics or in a resource. All events for the controls still will be generated.

Constants

None.

Example

REM Create a Window

REM Obtain the instance of the BBjAPI object
LET myAPI!=BBjAPI()

REM Open the SysGui device
SYSGUI=UNT
OPEN (SYSGUI) "X0"

REM Obtain the instance of the BBjSysGui object
LET mySysGui!=myAPI!.getSysGui()

REM Set common addWindow param values
X=10
Y=10
WIDTH=200
HEIGHT=200

REM Create a window with a title in the current context
TITLE$="BBj Window"
REM Set the current context
mySysGui!.setContext(0)
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

REM Register the CALLBACK routines
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

REM Process Events
PROCESS_EVENTS

REM Callback routine called when the user closes the application window
APP_CLOSE:
RELEASE
RETURN