dbShortLink2EditField Class Reference
[OOFILE GUI forms interface., Mac Specific]

#include <oofpp.h>

Inheritance diagram for dbShortLink2EditField:

[legend]Collaboration diagram for dbShortLink2EditField:

[legend]List of all members.

---

Detailed Description

Link a dbShort field to a LEditField for small text entry of numbers.

Note:

Concrete link used directly by name in previous OOFILE apps and so reimplemented this interface when we moved to the generic structure.

See also:

linkField(dbField*, LEditField*) generic link implementation.

mainly used by dbGUIadaptor
void	maybeChangeTargetLink ()
void	maybeDirty ()
virtual void	tellGUIcareAboutLocking () const
mainly used by dbEditHelper
virtual void	copyFieldToLink ()
virtual void	copyLinkToField ()
virtual bool	linkEqualsField () const
virtual bool	leaveLink ()
virtual void	readOnly (bool isReadOnly=true)
	Change readonly state of link to accept or deny data entry.
virtual bool	validToLeaveLink ()
	Validate field contents, overridden if can check just contents.
virtual bool	validToLeaveForm ()
	Validate unique fields to ensure can accept this record without error from database.
virtual void	highlightLink ()
	Visually highlight a link, usually becoming edit focus.
void	markClean ()
reflective calls
bool	isReadOnly () const
bool	alwaysReadOnly () const
bool	isDirty () const
bool	linkIsEmpty () const
dbGUIAdapter *	adapter () const
Public Member Functions
	dbShortLink2EditField (dbShort *fld, LEditField *ctl, bool becomeReadOnly=false)
virtual void	updateDerivedFieldDisplay (bool isNew)
dbHelper *	owner () const
void	owner (dbHelper *)
	not ctor param as can create without helper
dbField *	field () const
	purposely non-virtual as subclasses return different types
void	setField (dbField *inField)
bool	hidden () const
void	hide (bool hideIt=true)
virtual void	describe (std::ostream &) const
	Provide human-readable information about object.
virtual oofString	name () const
Protected Attributes
dbField *	mField
dbGUIAdapter *	mAdapter
	owned
dbHelper *	mOwner
bool	mMaybeDirty
	tentative flag lets us optimise comparisons
bool	mReadOnly
	default is read-write
bool	mAlwaysReadOnly
	for static controls, etc;
bool	mHidden
Friends
class	dbAbstractEditHelper
	so it can call PreApprovedReadOnly

---

Constructor & Destructor Documentation

dbShortLink2EditField::dbShortLink2EditField (  dbShort *  fld, LEditField *  ctl, bool  becomeReadOnly = false )  [inline]

---

Member Function Documentation

dbGUIAdapter * dbFieldLink::adapter (   )  const [inline, inherited]

bool dbFieldLink::alwaysReadOnly (   )  const [inline, inherited]

void dbFieldLink::copyFieldToLink (   )  [virtual, inherited]

Reimplemented in dbFieldPickLink, and dbBoolLink.

void dbFieldLink::copyLinkToField (   )  [virtual, inherited]

Reimplemented in dbFieldPickLink, and dbBoolLink.

void OOF_PublicBase::describe (  std::ostream &  os  )  const [virtual, inherited]

Provide human-readable information about object. Overriden to provide much more detail particularly for dbTable::describe() which provides full schema. Reimplemented in dbTable, dbConnect, dbField, dbChar, dbFixedBinary, and dbRelRefBase.

dbField * dbFieldLink::field (   )  const [inline, inherited]

purposely non-virtual as subclasses return different types Used by dbGUIAdapters such as dbGUIAdaptEditPane::setFieldLink to get the field in order to query database characteristics. Returns: dbField* to the field we link. Reimplemented in dbUshortLink.

bool OOF_PublicBase::hidden (   )  const [inline, inherited]

void OOF_PublicBase::hide (  bool  hideIt = true  )  [inline, inherited]

void dbFieldLink::highlightLink (   )  [virtual, inherited]

Visually highlight a link, usually becoming edit focus. dbAbstractEditHelper::ValidateLinks calls us to highlight the first invalid link it finds.

bool dbFieldLink::isDirty (   )  const [inline, inherited]

bool dbFieldLink::isReadOnly (   )  const [inline, inherited]

bool dbFieldLink::leaveLink (   )  [virtual, inherited]

Reimplemented in dbFieldPickLink, and oofRepEditLink.

bool dbFieldLink::linkEqualsField (   )  const [virtual, inherited]

Reimplemented in dbFieldPickLink, and dbBoolLink.

bool dbFieldLink::linkIsEmpty (   )  const [inherited]

void dbFieldLink::markClean (   )  [inline, inherited]

void dbFieldLink::maybeChangeTargetLink (   )  [inline, inherited]

void dbFieldLink::maybeDirty (   )  [inline, inherited]

oofString OOF_PublicBase::name (   )  const [virtual, inherited]

Reimplemented in dbTable, dbConnect, dbField, and OOF_adornerHolder.

void dbFieldLink::owner (  dbHelper *   )  [inline, inherited]

not ctor param as can create without helper

dbHelper * dbFieldLink::owner (   )  const [inline, inherited]

void dbFieldLink::readOnly (  bool  becomeReadOnly = true  )  [virtual, inherited]

Change readonly state of link to accept or deny data entry. Won't allow enabling editing if can't edit record due to locking.

void dbFieldLink::setField (  dbField *  inField  )  [inline, inherited]

void dbFieldLink::tellGUIcareAboutLocking (   )  const [virtual, inherited]

Reimplemented in oofRepEditLink.

void dbNumericFieldLink::updateDerivedFieldDisplay (  bool  isNew  )  [virtual, inherited]

Reimplemented from dbFieldLink. Reimplemented in dbDateLink2Editor, and dbDateTimeLink2Editor.

bool dbFieldLink::validToLeaveForm (   )  [virtual, inherited]

Validate unique fields to ensure can accept this record without error from database. Warning: you probably still want to call this method if you override. Reimplemented in dbFieldPickLink.

bool dbFieldLink::validToLeaveLink (   )  [virtual, inherited]

Validate field contents, overridden if can check just contents. Lightweight check that allows tabbing between fields in open record. See also: validToLeaveForm for heavier check. dbDateLink2Editor::validToLeaveLink Reimplemented in dbDateLink2Editor, and dbDateTimeLink2Editor.

---

Friends And Related Function Documentation

friend class dbAbstractEditHelper [friend, inherited]

so it can call PreApprovedReadOnly

---

Member Data Documentation

dbGUIAdapter* dbFieldLink::mAdapter [protected, inherited]

owned

bool dbFieldLink::mAlwaysReadOnly [protected, inherited]

for static controls, etc;

dbField* dbFieldLink::mField [protected, inherited]

bool OOF_PublicBase::mHidden [protected, inherited]

bool dbFieldLink::mMaybeDirty [protected, inherited]

tentative flag lets us optimise comparisons

dbHelper* dbFieldLink::mOwner [protected, inherited]

bool dbFieldLink::mReadOnly [protected, inherited]

default is read-write

---

The documentation for this class was generated from the following file:

• oofpp.h

---