|
of_accepttext
|
|
Full name
|
pfc_n_cst_dwsrv_linkage.of_accepttext
|
Access
|
public
|
Extend of
|
integer
|
Return value
|
integer
|
Prototype
|
public function integer of_accepttext(boolean)
|
Name
|
Datatype
|
li_i
|
Integer
|
li_numdetails
|
Integer
|
li_rc
|
Integer
|
public function integer of_accepttext (boolean ab_focusonerror);//////////////////////////////////////////////////////////////////////////////
//
// Function: of_AcceptText
//
// Access: Public
//
// Arguments:
// ab_focusonerror Indicates if focus should be set to the DW if an error is
// found.
//
// Returns: Integer
// 1 if it succeeds and -1 if an error occurs.
//
// Description: Performs AcceptText on the datawindows in the linked chain,
// starting with the top-level datawindow.
//
// Note: Typically called from the root datawindow to affect all datawindows in
// the chain, but may be started anywhere in the chain.
//
//////////////////////////////////////////////////////////////////////////////
//
// Revision History
//
// Version
// 5.0 Initial version
// 5.0.02 Do not perform AcceptText on Datawidows found on uncreated tab pages.
// 6.0 Enhanced so the datawindow requestor will perform its own accepttext
// functionality.
//
//////////////////////////////////////////////////////////////////////////////
//
// 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.
//
//////////////////////////////////////////////////////////////////////////////
Integer li_numdetails
Integer li_i
Integer li_rc=1
// Validate required reference.
If IsNull(idw_Requestor) or Not IsValid(idw_Requestor) Then Return FAILURE
// Perform the accepttext functionality.
If idw_Requestor.Event pfc_AcceptText(ab_focusonerror) <> 1 Then
Return FAILURE
End If
// Loop through the valid details and call this function on each detail.
li_numdetails = UpperBound ( idw_details )
For li_i = 1 to li_numdetails
If IsValid ( idw_details[li_i] ) Then
If IsNull(idw_details[li_i].inv_Linkage) Or &
Not IsValid ( idw_details[li_i].inv_Linkage ) Then Return FAILURE
li_rc = idw_details[li_i].inv_Linkage.of_AcceptText (ab_focusonerror)
// If an error occurs, get out now.
If li_rc <> 1 Then Exit
End If
Next
Return li_rc
end function