SCROLLPANE
|
Syntax: |
SCROLLPANE(<Row>,<Column>,<Height
in Rows>,<Width in Columns>,<Height of Column
Header>,<Width of Row Header>,<Type>,<Handle>)
|
||||||||||||||||
|
|
|
||||||||||||||||
|
Meaning: |
Creates
a Scrollpane. <Row> and <Column> specify the upper left corner and
<Height in Rows> and <Width in Columns> specify the height and
width of the Scrollpane in rows and columns. <Handle> specifies to which window the
instruction refers. <Handle> can contain the window depth or the handle
of a split window or a WINDOWCALL window. If the
parameter <Handle> is missing, the instruction refers to the current mask. If
handle is a handle of a split window the parameters <Row>,
<Column>, <Height in Rows> and <Width in Columns> have no
effect, the Scrollpane always uses the whole split window. A
Scrollpane consists of the following components:
The
components of a Scrollpane can be filled with the following instructions: With
each instruction the handle of the component to which the instruction refers
has to be specified. The
handle of a component of a Scrollpane can be obtained by the function GET_SCROLLPANE_HANDLE. Each
component is specified by a number which has to be passed to the function. Example:
HANDLE%
= SCROLLPANE(...) HANDLE_KOPFSPALTE%
= GET_SCROLLPANE_HANDLE(HANDLE%,2) <Type>
specifies whether Column Header and/or Row Header
are created.
The
corners 4, 5 and 6 are only shown if the corresponding scrollbars are
visible. The scrollbars are shown automatically when an element is added to
the scrollarea which exceeds the size of the scrollarea. Corner
3 is only display if the Scrollpane has a Column Header and a Row Header
(<Type> = 3). Attention: To increase speed the
instruction NOREPAINT can
be executed before elements are added to the scrollpane and REPAINT after elements have
been added. When
the mouse cursor is within a component of a Scrollpane the variables EBUS_SCROLLPANE_MOUSE_ROW and
EBUS_SCROLLPANE_MOUSE_COL
contain the mouse position within the component. If
with the instruction PRINT a handle of a
Scrollpane component is specified, the instruction CURSOR
refers to the upper left corner of the component, in other words the upper
left corner of the component has the CURSOR
coordinates (1,1). SCROLLPANE
returns the handle of the Scrollpane or -1 if the Scrollpane could not be
created. |
||||||||||||||||
|
Parameter: |
|
||||||||||||||||
|
Sample: |
The figure above has been created with the
following commands: HANDLE% = SCROLLPANE(3,3,10,40,2,20,3,0) H% = SET_SCROLLPANE_BACKGROUNDCOLOR(HANDLE%,0,255,255,255,-1,-1,-1,-1) H% = SET_SCROLLPANE_BACKGROUNDCOLOR(HANDLE%,1,196,196,255,-1,-1,-1,-1) H% = SET_SCROLLPANE_BACKGROUNDCOLOR(HANDLE%,2,255,196,196,-1,-1,-1,-1) FOR I%=3 TO 6 H% = SET_SCROLLPANE_BACKGROUNDCOLOR(HANDLE%,I%,0,196,0,-1,-1,-1,-1) ENDLOOP HANDLE_COLUMN_HEADER% = GET_SCROLLPANE_HANDLE(HANDLE%,1) HANDLE_ROW_HEADER% = GET_SCROLLPANE_HANDLE(HANDLE%,2) HANDLE_UPPER_LEFT_CORNER% = GET_SCROLLPANE_HANDLE(HANDLE%,3) HANDLE_UPPER_RIGHT_CORNER% = GET_SCROLLPANE_HANDLE(HANDLE%,4) HANDLE_LOWER_LEFT_CORNER% = GET_SCROLLPANE_HANDLE(HANDLE%,5) HANDLE_LOWER_RIGHT_CORNER% = GET_SCROLLPANE_HANDLE(HANDLE%,6) H% = FILLRECT(1,1,30,100,224,224,224,HANDLE%) CURSOR(1.5,4,HANDLE_COLUMN_HEADER%)
PRINT(HANDLE_COLUMN_HEADER%) "1
Column Header" CURSOR(4,5) PRINT(HANDLE_ROW_HEADER%) "2 Row Header" CURSOR(4,6) PRINT(HANDLE%) "0 Scrollarea" CURSOR(1.5,2) PRINT(HANDLE_UPPER_LEFT_CORNER%) "3 Upper
left corner" PRINTFONTHEIGHT
= 0.7 CURSOR(1.5,1.2) PRINT(HANDLE_UPPER_RIGHT_CORNER%)
"4"; CURSOR(0.85,10) PRINT(HANDLE_LOWER_LEFT_CORNER%) "5"; CURSOR(0.85,1.2) PRINT(HANDLE_LOWER_RIGHT_CORNER%) "6"; |
||||||||||||||||
|
See also: |
SET_SCROLLPANE_BACKGROUNDCOLOR |