Back to Contents Previous Next
13. Dynamic areas
FNwimp_createdynamic(size%,maxsize%,drag%,name$)
Creates a dynamic area and returns a handle for it. (This wimp-function needs RISCOS Version 3.60 or higher.)
size% = initial size of dynamic area in bytes.
maxsize% = maximum size of dynamic area in bytes. (-1 means “no limit” but use of this special value is not recommended.)
If drag% = 1 the user can change the size of the area by dragging in the Task Display.
name$ is the name of the dynamic area appearing in the Task Display.
Note: Dynamic area sizes may be restricted by the OS to multiples of 4kbytes (4096 bytes). Automatic rounding up will then occur. See Section 2.20 of Manual.
FNwimp_changedynamic(darea%,absolute%,size%)
Changes the size of a dynamic area.
darea% = handle of dynamic area to be resized.
If absolute%=1 then the size in bytes given in size% is the new absolute size of the dynamic area.
If absolute%=0 then the size in bytes given in size% is the amount to change the dynamic area size by. (In this case, if size% is positive then the area will become larger, if size% is negative then the area will shrink.)
Returns a handle for the dynamic area, which may not be the same location as before.
Note the point about ‘multiples of 4kbytes’ in FNwimp_createdynamic() above.
FNwimp_measuredynamic(darea%)
Returns the current size of a dynamic area in bytes.
darea% = handle of dynamic area to measure.
PROCwimp_deletedynamic(darea%)
Deletes a dynamic area.
darea% = handle of dynamic area to delete.
FNwimp_getfreeRAM
Returns the number of bytes of free RAM available.
Top of page Back to Contents Previous Next