PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Reading and refreshing the Palm structure
  • Position of current record
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Warning
From version 16, this feature is no longer available.
Reads information regarding the current record during an access to a Palm Pilot database. This information contains:
  • the content of record,
  • the category of record,
  • the position of record.
Note: All the read functions (PalmReadFirst, PalmReadLast, PalmReadNext, PalmReadPrevious and PalmPosition) can be used to read the record content.
Example
MyMemo is string // Message of notepad
MyCategory is string // Category of notepad

// Opens an access named "JEFFACCESS"
// on the PALM "Notepad" database of JEFF user
IF PalmLoad("JEFFACCESS","JEFF") = False THEN
Error("Error while accessing the PALM database" + ...
ErrorInfo())
EndProgram()
END
PalmReadFirst("JEFFACCESS")
WHILE PalmOut("JEFFACCESS")=False
MyMemo = PalmRead(palmDataInfo)
MyCategory = PalmRead(palmCategoryInfo)
TableAddLine(TABLE_MyTable, MyMemo, MyCategory)
PalmReadNext()
END

// Close the access
PalmClose("JEFFACCESS")
Syntax
<Result> = PalmRead([<Access Name>] [, <Information to Read>)
<Result>: Character string
Information about the current record. The Palm structure is refreshed with the content of record read.
<Access Name>: Optional character string (with quotes)
Name of access previously defined by PalmLoad. If this parameter is not specified, the last access handled by a PALM function is used.
<Information to Read>: Optional integer constant
Type of information about the record read in the specified access returned by the function:
palmCategoryInfoCategory of the current record (cannot be used on the Notepad database)
palmDataInfo
(default value)
Content of current record. Depends on the database used:
  • notepad: content of record
  • calendar: character string containing the following information, separated by space characters: date, start time, end time, description
  • task list: task description
  • address book: character string containing the following information, separated by space characters: last and first names
palmInfoPositionPosition of current record (takes into account the filter previously defined by PalmFilter)
Remarks

Reading and refreshing the Palm structure

When reading a record, the variables of the Palm structure are automatically refreshed.
The variables of Palm structure differ according to the Palm Pilot database (defined by PalmLoad).
For more details, see:

Position of current record

The position returned by PalmRead corresponds to the position of current record in the specified access. If the records of this access are filtered, the position of the current record is given in relation to all the records corresponding to the filter.
Therefore, the position of a record may differ depending on whether a filter is implemented or not.
Note: The position returned by PalmRead can be used by PalmPosition to re-position on a specific record.
Components
WINDEVReports and Queries wd230plm.dll
Linux wd230plm.so
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment