DumontEXE 0.0.1
Public Slots
cmcItemField Class Reference

Form Field. More...

#include <cmcItemField.h>

Inheritance diagram for cmcItemField:

List of all members.

Public Slots

virtual QString label ()
 Field Text Label (passthru)
virtual void value (bool value)
 Set Field Boolean Value
.
virtual void value (QString value)
 Set Field Text Value.
virtual QString value ()
 Get Field Text Value (passthru)

Detailed Description

Form Field.

Definition at line 48 of file cmcItemField.h.


Member Function Documentation

QString label ( ) [virtual, slot]

Field Text Label (passthru)

This returns the 'Label' of the Form field. This is a passthrough function that transfers control directly to the Commence Form.Field object and therefore returns the same data as the standard Form.Field("Name").Label call.

vbScript example:
 msgbox dfrm.Field("calendarKey").Label
Note:
This value is cached so that repeated lookups do not make repeated calls into the Commence API.

Implements cmcField.

Definition at line 59 of file cmcItemField.cpp.

void value ( QString  value) [virtual, slot]

Set Field Text Value.

This sets the 'Value' of the Form field. This is a passthrough function that transfers control directly to the Commence Form.Field object and therefore sets the same data as the standard Form.Field("FieldName").Value = "xyz" call.

Note:
This function also tests the new value against the current value, and if there is no change then no updates will be performed on the database. This can help reduce the number of updates the database has to sync around the workgroup in the event no real data is changing on the field. This is particularily useful when scripted-updates are occuring on various text-type-memo fields that the user doesn't update, but the script updates automatically. The script can just update the field value blindly and if there is an actual data field change, then, and only then will that change be written to the commence field, thus reducing the amount of data that has to get synced around the workgroup.
vbScript example:
 dfrm.Field("calendarKey").Value = "new value"

Implements cmcField.

Definition at line 99 of file cmcItemField.cpp.

void value ( bool  value) [virtual, slot]

Set Field Boolean Value
.

This function sets a boolean value. Boolean values must receive special treament since a Form.Field boolean field requires one set of boolean logic, and a RowSet.Field requires another. Therefore, this routine gets implemented in one of the subclasses.

Implements cmcField.

Definition at line 107 of file cmcItemField.cpp.

QString value ( ) [virtual, slot]

Get Field Text Value (passthru)

This returns the 'Value' of the Form field. This is a passthrough function that transfers control directly to the Commence Form.Field object and therefore returns the same data as the standard Form.Field("Name").Value call.

vbScript example:
 msgbox dfrm.Field("calendarKey").Value

Implements cmcField.

Definition at line 64 of file cmcItemField.cpp.


The documentation for this class was generated from the following files:
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties




~ ~ ~ ~ ~ ~
Source Code without Comments is like a Cranberry Garland
without the berries. Comment your Code!
 
Commence Database User Support Group Forum
http://newsgroup.showoff-db.org/
~ ~ ~ ~ ~ ~
Author: Mark Petryk
Lorimark Solutions, LLC
mark@lorimarksolutions.com