NeilArmstrong: Added glossary link to Record~

2012-04-09T04:18:10Z

Added glossary link to Record~

← Older revision		Revision as of 04:18, 9 April 2012
Line 32:		Line 32:
	== When to Use More Than One TFMFiler Component on a Form ==		== When to Use More Than One TFMFiler Component on a Form ==

	Typically, you would want to devote one TFMFiler component for each discrete set of fields you need to file values for on a form. If you are editing a set of fields from a top-level record, and also a set of fields for ~~records~~ in a multiple, for example, ordinarily you would use separate TFMFiler component for the multiple vs. the top-level record. This keeps separate the change list for the multiple from the change list of the top-level record, allowing each set of fields to be filed individually.		Typically, you would want to devote one TFMFiler component for each discrete set of fields you need to file values for on a form. If you are editing a set of fields from a top-level [[record~\|Record]], and also a set of fields for [[record~\|Record]]s in a multiple, for example, ordinarily you would use separate TFMFiler component for the multiple vs. the top-level [[record~\|Record]]. This keeps separate the change list for the multiple from the change list of the top-level [[record~\|Record]], allowing each set of fields to be filed individually.

	Descriptions of properties inherited from the parent component are not listed here (only those properties added to the parent component are described).		Descriptions of properties inherited from the parent component are not listed here (only those properties added to the parent component are described).

	For help on inherited properties, please refer to Delphi's documentation on the parent component.		For help on inherited properties, please refer to Delphi's documentation on the parent component.

DavidWhitten at 21:08, 8 February 2011

2011-02-08T21:08:17Z

New page

== TFMFiler Component ==

* TFMFiler Component [[FileMan_Delphi_Components/TFMFiler_Properties|Properties]]
* TFMFiler Component [[FileMan_Delphi_Components/TFMFiler_Methods|Methods]]
* TFMFiler Component [[FileMan_Delphi_Components/TFMFiler_Example|Example]]
* [[FileMan_Delphi_Components/TFMFiler_See_Also|See Also related topics]]
* Defined in the [[FileMan_Delphi_Components/Fmcmpnts|Fmcmpnts Unit]]

== Parent Class ==

<code> TFMFiler = class([[FileMan_Delphi_Components/TFMAccess|TFMAccess]]) </code>

== Description ==

The purpose of the TFMFiler component is to file changes to the database. It uses the [http://hardhats.org/fileman/pm/db_die_f.htm <code>FILE^DIE</code>] and [http://hardhats.org/fileman/pm/db_die_u.htm <code>UPDATE^DIE</code>] DBS calls to file changes to the database.

For step-by-step instructions on filing data with a TFMFiler component, please refer to the "[[FileMan_Delphi_Components/How_To_File_Changes|How to File Changes]]" topic.

== Internal Lists ==

The TFMFiler component maintains two lists of data to file:

=== ChangedCtrlsList ===
A list of VA FileMan data controls containing data that should be filed (for example, the name of a [[FileMan_Delphi_Components/TFMEdit|TFMEdit]] component). Use the [[FileMan_Delphi_Components/TFMFiler_AddChgdControl|AddChgdControl]] and [[FileMan_Delphi_Components/TFMFiler_RemoveChgdControl|RemoveChgdControl]] methods to add and remove VA FileMan data controls from this list. The file, IENS, field, and data value to file are obtained from the named VA FileMan data control's properties at the time the [[FileMan_Delphi_Components/TFMFiler_Update|Update method]] is called.
=== FDAList ===
An internal list holding data FDAs to be filed that is not associated with any VA FileMan data control. Place items on this list with the [[FileMan_Delphi_Components/TFMFiler_AddFDA|AddFDA method]]. For example, you could ask for a value to be filed in a given file, IENS, and field, independent of any VA FileMan data control.

To file the items in these two lists into the database, use the TFMFiler component's [[FileMan_Delphi_Components/TFMFiler_Update|Update method]]. To clear the two lists, use the [[FileMan_Delphi_Components/TFMFiler_Clear|Clear]] method. To find out if there are any items in the lists waiting to be filed, use the [[FileMan_Delphi_Components/TFMFiler_AnythingToFile|AnythingToFile method]].

== When to Use More Than One TFMFiler Component on a Form ==

Typically, you would want to devote one TFMFiler component for each discrete set of fields you need to file values for on a form. If you are editing a set of fields from a top-level record, and also a set of fields for records in a multiple, for example, ordinarily you would use separate TFMFiler component for the multiple vs. the top-level record. This keeps separate the change list for the multiple from the change list of the top-level record, allowing each set of fields to be filed individually.

Descriptions of properties inherited from the parent component are not listed here (only those properties added to the parent component are described).

For help on inherited properties, please refer to Delphi's documentation on the parent component.

FileMan Delphi Components/TFMFiler - Revision history

NeilArmstrong: Added glossary link to Record~

DavidWhitten at 21:08, 8 February 2011