of_insertitem


pfcmain.pbl   >   pfc_u_lvs   >   of_insertitem   

Full name pfc_u_lvs.of_insertitem
Access public
Extend of integer
Return value integer
Prototype public function integer of_insertitem(ref n_ds,long,string,integer)

Name Datatype
No Data

Name Datatype
No Data

public function integer of_insertitem (ref n_ds ads_obj, long al_row, string as_position, integer ai_index);//////////////////////////////////////////////////////////////////////////////
//
//	Function:	of_InsertItem
//
//	Access:		public
//
//	Arguments:
//	ads_obj		The DataStore containing the data to be used for the new item.
//						This can be the same DataStore that was created for the listview, or
//						another maintained by the user.  If the latter, the row will be added
//						to the listviews DataStore.  Passed by reference.
//	al_Row		The row in the DataStore pointing to the data.
//	as_Position	The position under the parent where the new item will be inserted:
//						"First" - before the first item of the listview 
//						"Last" - after the last listview item (default)
//						"Before" - before the item with index al_Item
//						"After" - after the item with index al_Item
//	ai_Index		The index to the item which the new item will be inserted either after or before.
//						Ignored unless as_Position = "After" or "Before".
//
//	Returns:		Integer
//					Returns the index of the item if it was added successfully, 
//					-1 if an error occurrs.
//
//	Description:	Add a new item to the ListView using data from a DataStore.
//
//////////////////////////////////////////////////////////////////////////////
//
//	Revision History
//
//	Version
//	6.0   Initial version
//
//////////////////////////////////////////////////////////////////////////////
//
//	Copyright © 1996-1997 Sybase, Inc. and its subsidiaries.  All rights reserved.
//	Any distribution of the PowerBuilder Foundation Classes (PFC)
//	source code by other than Sybase, Inc. and its subsidiaries is prohibited.
//
//////////////////////////////////////////////////////////////////////////////

// check arguments
if IsNull(ads_obj) or not isvalid(ads_obj) Then Return -1
If IsNull(as_position) or (trim(as_position) = "") Then return -1
if IsNull(ai_index) or (ai_index < 0) then return -1
If IsNull(al_row) or (al_row = 0) then return -1

Return this.event pfc_insertitem(ads_obj, al_row, as_position, ai_index)
end function

     
Name Owner
No Data

     
Name Owner
systemfunctions.isnull systemfunctions
systemfunctions.isvalid systemfunctions
systemfunctions.trim systemfunctions
pfc_u_lvs.pfc_insertitem pfc_u_lvs

     
Full name
No Data

     
Name Scope
No Data