Documentation
| Chapter 25. databaseforms | ||
|---|---|---|
 | Part III. SIMPOL-Language Libraries |  |
Table of Contents
- dataform1
- dataform1arc
- dataform1bitmap
- dataform1bitmapbutton
- dataform1bitmapsource
- dataform1button
- dataform1checkbox
- dataform1combo
- dataform1controlsource
- dataform1datagrid
- dataform1datagridcolumn
- dataform1datasource
- dataform1detailblock
- dataform1edittext
- dataform1ellipse
- dataform1grid
- dataform1line
- dataform1link
- dataform1list
- dataform1option
- dataform1optiongroup
- dataform1page
- dataform1record
- dataform1rectangle
- dataform1scrollbar
- dataform1table
- dataform1text
- dataform1triangle
- fdevent
- pageresizeinfo
- printform1
- printform1arc
- printform1bitmap
- printform1control
- printform1ellipse
- printform1graphic
- printform1line
- printform1page
- printform1rectangle
- printform1text
- printform1triangle
- createblankbmp()
- getarcboundingrectangle()
- getarcquadrant()
- getbitmaptype()
- getellipseboundingrectangle()
- hasproperty()
- isvaliddbcontrol()
- renderprintform1page()
- retrievebitmap()
The databaseforms library is the implementation of data-aware forms for SIMPOL. They are a wrapper around the wxform* objects supplied by the WXWN component. The databaseforms library provides a multi-page, data-aware layer that includes the data-aware bitmap, data-aware scrollbar, data-aware grid, and detail block implentations, among others. It also provides the grouping mechanism for option buttons. This library is key to efficiently creating database-aware GUIs using SIMPOL. One significant difference between dataform1* and the native wxform* types is the use of drings in dataform1 for collections of objects. To traverse a dring use the dring.getfirst() to retrieve the first object, and then the getnext() method of the appropriate node property of the object to get to the next.
Objects of type dataform1 have no value, and it is an error to try to get or set this value.
dataform1.new (
dataform1 medefpagewidthdefpageheightdefpagebackcolordefbooleanformatdefintegerformatdefnumberformatdefdateformatdeftimeformatdefdatetimeformatdefdatelocaledefnumericlocaledeffontdesigndpierror
| Parameter | Default value | Type name | Description |
|---|---|---|---|
| me | None | dataform1 | |
| defpagewidth | 50 | integer | |
| defpageheight | 50 | integer | |
| defpagebackcolor | 16777215 | integer | |
| defbooleanformat | T|F | string | |
| defintegerformat | . | string | |
| defnumberformat | 999999.00 | string | |
| defdateformat | yyyy.0m.0d | string | |
| deftimeformat | hh:mm:ss | string | |
| defdatetimeformat | None | string | |
| defdatelocale | None | SBLlocaledateinfo | |
| defnumericlocale | None | SBLNumSettings | |
| deffont | None | wxfont | |
| designdpi | 96 | integer | |
| error | None | integer |
| Property | Type | Description |
|---|---|---|
| _ | type(*) | |
| __ | type(*) | |
| _private | dataform1private | |
| addbitmap | function | |
| addcontrol | function | |
| adddatasource | function | |
| adddetailblock | function | |
| addgraphic | function | |
| addlink | function | |
| addoptiongroup | function | |
| addpage | function | |
| addsiblinglink | function | |
| addtable | function | |
| autolocking | boolean | |
| bitmaps | dring | |
| blank | function | |
| checkdirtyrecords | function | |
| clearlinks | function | |
| clearsiblinglinks | function | |
| container | type(wxcontainer) | |
| controls | dring | |
| currentdpi | integer | |
| currentpage | dataform1page | |
| datasources | dring | |
| defbooleanformat | string | |
| defdateformat | string | |
| defdatelocale | SBLlocaledateinfo | |
| defdatetimeformat | string | |
| deffont | wxfont | |
| defintegerformat | string | |
| defnumberformat | string | |
| defnumericlocale | SBLNumSettings | |
| defpagebackcolor | integer | |
| defpageheight | integer | |
| defpagewidth | integer | |
| deftimeformat | string | |
| deleterecord | function | |
| designdpi | integer | |
| designmode | boolean | |
| detailblocks | dring | |
| dirty | boolean | |
| discardrecord | function | |
| dpiadjfactor | number | |
| filename | string | |
| filllists | function | |
| filter | dataform1filter | |
| findbitmapsource | function | |
| findcontrol | function | |
| finddatasource | function | |
| findgraphic | function | |
| findsiblinglink | function | |
| findtable | function | |
| fonts | array | |
| getfieldandtable | function | |
| getfont | function | |
| graphics | dring | |
| links | dring | |
| lock | function | |
| locked | boolean | |
| masterrecord | dataform1record | |
| mastertable | dataform1table | |
| name | string | |
| nameinuse | function | |
| newrecord | function | |
| obgroups | dring | |
| onchangerecord | event | |
| ondelete | event | |
| ondiscard | event | |
| onkey | event | |
| onkeylostfocus | event | |
| onnewrecord | event | |
| onsave | event | |
| onselect | event | |
| pages | dring | |
| preventfocus | boolean | |
| preventfocusmode | boolean | |
| refresh | function | |
| saverecord | function | |
| selectcurrent | function | |
| selectfirst | function | |
| selectkey | function | |
| selectlast | function | |
| selectnext | function | |
| selectprevious | function | |
| setcontainer | function | |
| setdirtystate | function | |
| setkeyfocus | function | |
| setmasterrecord | function | |
| setmastertable | function | |
| showpage | function | |
| siblinglinks | dring | |
| tables | dring | |
| type | type | |
| unlock | function | |
| valid | boolean |
dataform1var.addbitmap (
dataform1 mefilenameformatrgbwidthheighterror
dataform1var.addcontrol (
dataform1 mecontroltypelefttopwidthheighttextenabledvisiblebitmapscalingselectedbitmapdisabledbitmapfocusbitmapbackgroundrgbtextrgbrgbedittypeselectiontyperowcountcolcountrowheightcolwidthrowheightdraggablecolwidthdraggablerowlabelwidthcollabelheightrowlabelalignmentcollabelalignmentalignmenteditstyleorientationrangepositionpagesizethumbsizefontlabelfonttooltiponmousemasknamenextpagevalueonvalueofffieldtabledisplayformatobgrouperror
| Parameter | Default value | Type name | Description |
|---|---|---|---|
| me | None | dataform1 | |
| controltype | None | type | |
| left | None | integer | |
| top | None | integer | |
| width | None | integer | |
| height | None | integer | |
| text | None | string | |
| enabled | .true | boolean | |
| visible | .true | boolean | |
| bitmap | None | wxbitmap | |
| scaling | None | string | |
| selectedbitmap | None | wxbitmap | |
| disabledbitmap | None | wxbitmap | |
| focusbitmap | None | wxbitmap | |
| backgroundrgb | None | integer | |
| textrgb | 0 | integer | |
| rgb | None | integer | |
| edittype | droplist | string | |
| selectiontype | single | string | |
| rowcount | 1 | integer | |
| colcount | 1 | integer | |
| rowheight | None | integer | |
| colwidth | None | integer | |
| rowheightdraggable | None | boolean | |
| colwidthdraggable | None | boolean | |
| rowlabelwidth | 80 | integer | |
| collabelheight | 20 | integer | |
| rowlabelalignment | right | string | |
| collabelalignment | None | string | |
| alignment | None | string | |
| editstyle | None | string | |
| orientation | None | string | |
| range | 1 | integer | |
| position | 0 | integer | |
| pagesize | 1 | integer | |
| thumbsize | 1 | integer | |
| font | None | wxfont | |
| labelfont | None | wxfont | |
| tooltip | None | string | |
| onmousemask | 0 | integer | |
| name | None | string | |
| next | None | type(dataform1control) | |
| page | None | dataform1page | |
| valueon | None | anyvalue | |
| valueoff | None | anyvalue | |
| field | None | type(db1field) | |
| table | None | dataform1table | |
| displayformat | None | string | |
| obgroup | None | dataform1optiongroup | |
| error | None | integer |
dataform1var.adddatasource (
dataform1 medatasourcesourceusernamepassworderror
dataform1var.adddetailblock (
dataform1 mepagecontrolsrowsrowoffsetcolumnscolumnoffsetscrollbarscrollbaroffsettabacrossnamereadonlyerror
dataform1var.addgraphic (
dataform1 megraphictypepoint1point2point3midpointrgbborderrgbwidthborderwidthvisiblebordervisiblenamenextpageerror
| Parameter | Default value | Type name | Description |
|---|---|---|---|
| me | None | dataform1 | |
| graphictype | None | type | |
| point1 | None | point | |
| point2 | None | point | |
| point3 | None | point | |
| midpoint | None | point | |
| rgb | None | integer | |
| borderrgb | None | integer | |
| width | None | integer | |
| borderwidth | None | integer | |
| visible | None | boolean | |
| bordervisible | None | boolean | |
| name | None | string | |
| next | None | type(dataform1graphic) | |
| page | None | dataform1page | |
| error | None | integer |
dataform1var.addlink (
dataform1 mesrcfieldsrctabledestfielddesttablecontainererror
dataform1var.addoptiongroup (
dataform1 menamefieldtabledisplayformaterror
dataform1var.addpage (
dataform1 mewidthheightbackgroundrgbaftererror
dataform1var.addsiblinglink (
dataform1 mesrcfieldsrctabledestfielddesttablecontainererror
dataform1var.addtable (
dataform1 metablesourceerror
dataform1var.getfont (
dataform1 mefacenamesizestyleweightdecoration
dataform1var.selectcurrent (
dataform1 meindexlockerror
dataform1var.selectkey (
dataform1 mevalueindexlockfounderror
dataform1var.setkeyfocus (
dataform1 meonkeyonkeyreferenceonlostfocusonlostfocusreference
dataform1var.setmasterrecord (
dataform1 merdorefresherror
| |  | |
| writeprivateprofilestrings() |  | dataform1arc |