of_getsheetsbytitle


pfcwnsrv.pbl   >   pfc_n_cst_winsrv_sheetmanager   >   of_getsheetsbytitle   

Full name pfc_n_cst_winsrv_sheetmanager.of_getsheetsbytitle
Access public
Extend of integer
Return value integer
Prototype public function integer of_getsheetsbytitle(ref window[],string,boolean)

Name Datatype
No Data

Name Datatype
li_counter integer
lw_sheet window

public function integer of_getsheetsbytitle (ref window aw_sheet[], string as_title, boolean ab_partialmatch);//////////////////////////////////////////////////////////////////////////////
//
//	Function:  of_GetSheetsbyTitle
//
//	Access:  public
//
//	Arguments:
//	aw_sheet[] by ref
//	as_title:  title of the sheets to get
//	ab_partialmatch:  partially match window titles (default is false)
//
//	Returns:  integer
//	number of sheets open with title specified
//	-1 = error
//
//	Description:  Get reference to all open sheets with title specified
//
//////////////////////////////////////////////////////////////////////////////
//
//	Revision History
//
//	Version
//	5.0   Initial version
//
//////////////////////////////////////////////////////////////////////////////
//
//	Copyright © 1996-1999 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_counter
window	lw_sheet

// Validate window requestor
if IsNull(iw_requestor) Or not IsValid (iw_requestor) then
	return -1
end if

// Get all sheets of title specified
lw_sheet = iw_requestor.GetFirstSheet ()
if IsValid (lw_sheet) then
	do
		if ab_partialmatch = false then
			if lw_sheet.title = as_title then
				li_counter++
				aw_sheet[li_counter] = lw_sheet
			end if
		else
			if Pos (lw_sheet.title, as_title) > 0 then
				li_counter++
				aw_sheet[li_counter] = lw_sheet
			end if
		end if
	
		lw_sheet = iw_requestor.GetNextSheet (lw_sheet)
	loop until IsNull(lw_sheet) Or not IsValid (lw_sheet)
end if

return li_counter


end function

     
Name Owner
pfc_n_cst_winsrv_sheetmanager.of_getsheetsbytitle pfc_n_cst_winsrv_sheetmanager

     
Name Owner
window.getfirstsheet window
window.getnextsheet window
systemfunctions.isnull systemfunctions
systemfunctions.isvalid systemfunctions
systemfunctions.pos systemfunctions

     
Full name
No Data

     
Name Scope
No Data