Class: Data_List_mixin

internal

This disables no_refresh_state. This property is internal and will probably go away (along the no_refresh_state) don't mess with this

internal non-ds

dflt refresh col

dflt refresh row

internal

internal

internal.optimizer

optimizer. Non_DS only

index order - private.. use ordering

This is the current index direction. If true, index is reversed

If True, the DDO server is use if the DDO exists and it specifies an ordering. You usually set the DDO ordering when you have constraints and you always want the optimal index. In such a case it makes sense that the dbList or dbGrid should use this optimal index. This is set false for historical reasons. True is actually a better setting.

internal as of 15.1 we changed all deactivating/activating signatures to not return values (see windows.pkg / ComboForm / Activating for more) Returns Integer

add row at end of item list

Add_Rows: Load records into table very internal Pass: Direction and number of rows to add (to top or bottom). Current top or bottom record must be in buffer. Returns: number of rows actually added.

Adjust a current grid. This is called when the maximum number of rows changes in a non batch grid. Rather than just doing a display to refresh the grid we add and single rows as needed without changing the current row's data. This way you can resize dbGrids with changed data without losing that data.

add blank row at end of item list

add row at end of item list & display

This should only get called by an iEntry procedure

Internal: Fill from top or bottom of the table based on dir If the table is empty then we will use the Initial_Column as our column. If the table has lines. we use the current column position.

created for Server support notification of clear-record

created for Server support notification of clear-set

Replaced with proc below 03/27/95 procedure Clear_Current_Record integer ser# //oldchg get Server to ser# // // NOTE: Clear may cause problems with other tables on the same data_Set // If Ser# ne 0 Send Clear to ser# else Send vClear (Main_File(self)) end_procedure alternate better method for clearing file. If deferred or main-file is not the same as the server then only the buffer should clear.

invoked by append_blank_row and insert_blank_row

created for Server support notification of derived clear

Function Col_Index public return the best Index for this column or -1 if no choice is good This is useful for override and augmentation. When the Auto_Reorder_List message is invoked as part of iEntry this gets called. If we override it we can do some custom selections for a choice of index.

this can only be used with recnum tables. You are better off using Get CurrentRowId (to get the real rowId) or Get CurrentRowHasRecord (to see if you have a record)

returns true if current row has a RowId

remove given row#

use of lineDisplayState is required because the list sends its Server msgs Clear and Find when it only wants to affect the current row

-------------------------------------------------------------------- All record finding handled by these routines -------------------------------------------------------------------- Procedure Display_UI Procedure Display_Other_UI Procedure Read_by_Recnum record Procedure Establish_Find_Mode find_mode Procedure Read_Next_Record Procedure Find_Init Direction Procedure Clear_Current_Record Function File_record Returns Record display other UI objects. If server only do this if the deferred_state to false (also do a request assign). if no server this is idea for override JJT- Modify to never set no_refresh_state to true. This was an optimzation that never should have happened. By disabling this, display_other_ui acts exactly like display_ui. So, this message might go away in the future.

note also sets base_Item and record_rowId

display all UI objects. If server only do this if the deferred_state to false (also do a request assign). if no server just do the one object - JJT Don't send request_assign if already assigned - JJT Pass main_file with request_assign

This is called in VDF when GuiSize changes. It is not called anywhere in character mode, but it could be and it will work If the number of displayable rows changes we need to refresh non-batch list by sending display. This is called by set GuiSize and could be called by other methods that affect the number of rows in a grid.

messages added to support reversing index ordering

Good for augmentation.

created to empty list item data (aug'd by SelList)

Establish finding direction Pass: Mode

If you try this with a non-recnum table you will get a runtime error

Function: FileRowId Returns: The record number of the record currently in the buffer Return FOUND if record is active

Function: Fill_next_Row Pass: Row# - The record for this row MUST be rsNewAtBottom or rsNewAtTop -1 = find down, -2 = find up. Return: 1 if found. if rsNewAtBottom or rsNewAtTop it is not found New record and related in buffer

Internal Fill list around Row# Col# based on the current active record buffer

Find_Current_Buffer: Public Message find record that matches the record buffer, Current record should be inactive --- Forces load buffer record..does not notify others.

Refind & relate the record in rec# by Main_file. If you try this with a non-recnum table you will get a runtime error

Refind & relate the record in rec# by Main_file

This handles translation of find modes to make reverse ordering work. Pass the mode and return the mode, translated if reverse ordering is needed

Added to make this work like the old 3.01 data_list

Internal: for override

insert & display row before specified row#

insert row before specified row#

private implementation: created post 8.2-JJT Called by refresh (which is called by DDs) The purpose is to return true if the refresh is part of a parent/child constrained autofill. When autofill is called the grid or dblist needs to refresh based around an initial row and column (e.g. filling an order entry detail table). When not autofill the refresh should be based around the current row and column (e.g. filling a dblist). The method for determining if this is a DD based autofill is imperfect and might be changed in future revisions.

This was changed in 8.1 to better handle incremental searches with non-bacth lists.

Load_Page: Load page starting at row#. Internal Pass: Row# to load from. MUST have starting record in buffer Returns: The records new row (in case it got adjusted). Will relocate if the top is not filled. Note that the record is not in the buffer any more.

Public: Move to the selected column...

Augmented to return the DDOs server if the DDO should provide this information.

added for dependent-items support

Read_By_Recnum: Pass: Rec# find from server or from direct file. Returns: FOUND if record found and records in buffer & related If you try this with a non-recnum table you will get a runtime error

Read_Next_Record Return: FOUND, and record in and related

Create this message because the old 3.01 data-list did it this way. (Avoid this if possible - use Read_by_recnum. This might go away). If you try this with a non-recnum table you will get a runtime error

this can only be used with recnum tables. You are better off using Get record_rowId (to get the real rowId) or Get RecordStatus (to check top or bottom) or RowHasRecord

-------------------------------------------------------------------

Public: refresh page will refresh the screen both up and down. Based on the contents of the active record buffer. This allows for proper multi-user refreshes

Public: Reorder_list Assign Index and refresh screen based. Parameter: iNewCol is optional, if not passed use current column If bacth or if the DDO controls the ordering, nothing happens

Set index to idex number iIndex and refresh.

Assume the From# comes pre-loaded with its current record return with current record for the returned item (to#)

This returns true if the ordering should come from the DDO. This only happens if the pbUseServerOrdering is T and there is a server with an ordering property. If T, the ordering property will return the DDOs ordering. Important: If DDO has no Ordering (it usually does not), this returns false indicating that the ordering for the list is provided by the list

NOTE: Although Set record_rowId, Set RecordStatus, Set CurrentRowId and Set CurrentRecordStatus are all public they should be used *very* carefully. A row is defined by its RowId and it's status. If you chnange one your probably want to change both. RecordStatus also is overloaded for historical purposes. If the table is is a recnum table it contains a recnum or a 0, top or bottom. If rowId it contains 1 or 0, top bottom. If you mess with these methods you must handle this properly. Look at procedure display_row to see how this is done. In general, you should never need to use these set messages. They are very low level and make it easy to break things.

Set is augmented to send OnNewOrdering when order changes. Can be used to change the pbReverseOrdering property on a column by column basis (by default this does nothing) If the DDO determines the server, the set is canceled

================================compatibility methods================ Set record_number/Current_record will generate errors because you should not set these without setting the RowId array. If you are calling this you need to make code changes.

force to fit within visible table

------- Various direct file commands. Called when no server ----

private: only used by non-batch lists

If you try this with a non-recnum table you will get a runtime error