Casio PA-2400W manual Use of SIPanel Library, Restrictions, Program for starting up the library

Page 26

4.2 Use of SIPanel Library

Program for starting up the library

Before use of the SIPanel library, a dedicated program must be created to start up the library. The following is the method to call.

Create a dedicated program to call the library, separate from application program for business use. This dedicated program must be programmed so that the SIPanel library is called when a message is released by the application program to the dedicated program. It should be stored in the root directory of “My

Handheld PC”.

Avoid having the application program to call directly the SIPanel library. Instead, always use such the method that a message released by the application program can make the dedicated program start up the

library.

A sample program for the dedicated program mentioned above is on page xxx. You may refer to it to create your own dedicated program of calling the library.

Registry

After a dedicated program is created, the registry of the SIPanel must be rewritten to the following values. The values can be changed with “RegSetValueEx” function of Win32API.

Key name : LocalMachine\Software\Apps\SIPManager

SIPExeName = sipanel.exe -> SIPExeName = a name of the dedicated program

By having the registry values to be re-written, a user created program to start up the SIPanel can be also possible when the SIP button at upper-left corner of the PA-2400W is pushed. Or, if you wish to disable the startup, delete the values of Key name above.

Once user’s own SIPanel startup program is created, the registry must be re-written (or the registry must be deleted). Otherwise, it may crash to the original SIPanel startup program of the built-in ROM when the SIP button is pushed.

4.3 Restrictions

The SIPanel function is subject to the following restrictions.

The SIPanel screen may be hidden behind a display that is associated with an application, such as

PowerPoint, if one is used.

If the SIPanel library is called directly by application software, you may not be able to input characters into an object input area. Always follow the method described in Chapter 4.2 “Use of SIPanel Library” when it is called.

26

Image 26

Contents PA-2400W Library Manual VersionTable of Contents Fchkce /G Fchkce /C Preface CasioSystem Library Bootup LibrarySupported Files SIPanel LibrarySystem configuration Host PC PA-2400W CopySIPanel Library 3 I/O Bootup LibraryDedicated Library and Utility System Library File Transfer Utility File Check UtilityDevelopment Environment System Library Overview Parameters None Return Values Details of FunctionTitle Function Header #include CasioSys.h RemarksTurns off the backlight Language Interface Calling Sequence False TrueBacklight is on Backlight is offHeader #include CasioSys. h Remarks DisablePowerOff Bool EnablePowerOff Header Disable the power to be turned off with the power buttonEnable the power to be turned off with the power button Bool ApoCountReset Void SoftReset Language Interface Calling Sequence Disables automatic power-on with the alarmInternal error Parameters Bool bModeBool GetPowerOnAlarm Default Sample program to acquire power-on event notification Bool GetPowerEventStat SIPANEL.EXE SIPanel Library OverviewSIPANEL.DLL Program for starting up the library Use of SIPanel LibraryRestrictions RegistryLpctstr lpParam Sipshow SiphideSample program to start up the SIPanel Hinstance LptstrTchar ClassNameTSR = TEXTSipTsr Sample program of application software for business useTchar ClassName = Text CallSip HbCallText = CreateWindow TEXTbutton, TEXTText AreaLpCmdLine HWnd = CreateWindowClassName, ClassNameWsvisible Wsoverlapped Wssysmenu Find SipTsr Sw,h Options of Command LinePx,y IOBOX1.DLL O Bootup Library OverviewFunction Port294,967,295 msec. equals to Infinite Infinite = No timeoutDword Fail to call the functionUse of ioboxchk Sequential ModeMultiple-Thread Mode = Null Sample ProgramHwnd WINDOWHEIGHT/2 WsoverlappedWINDOWWIDTH/2 NullCase Wmpaint Wait for 5 seconds Registry of Libraries Disable the power on by alarmEnable the power on event notification IrDA 1.0 Interface File Transfer Utility OverviewRS-232C Interface List of Supported Commands Operation Use of FlceTermination of Flce Input ParameterRestrictions Types of Arguments Communication CommandsOptions OverwriteMethod of Describing Pathname Reference Storage Card PC card My Documents Internal RAMDOS Windows95 /Windows NT Required Error if omittedSpecifying Non-existing File Windows CESetting Up Registry Setting Up ItemsLong lReg1 Setting Up Registry with User ApplicationHkey hKey1 Dword Disp1Err=FALSE Else If err==TRUE Return errTermination Codes Should take an action that is appropriate to each definitionError Code Meaning Possible Cause Remedy Location of Log File Log FileLog File Name Method of Creation12Precautions Details of Command and Option Flce /S \casio\*.dat d\casiodat\ Transmission file pathnameDestination directory pathname Flce /SR \casio\*.dat d\casiodat\\12\*.dat d\casio\*.* \casio data\ PathnamePathname of requested file Flce /RR a\12\*.dat d\casio\*.* \casio data\Flce /A \MY\casio.dat b\your\master.dat Appended file pathnameTarget file pathname Pathname of file to be deleted Without the R option Flce /N a\ 12\kk.dat a\casio\ Source pathnameDestination pathname Flce /N a\12\kk.dat a\casio\sj.datParameters None SetupExample Flce /SR \casio ap\*.* \casio ap\ /TFlce /Y=COM1, , casio.scr Session with PCFlce casio.scr Session between PA-2400W-and-PA-2400WCommand and Status Idle notificationPreparation at PC Retry Process When Downloading FileRetry Method \soft\Retry.scr RestrictionPreparation at PA-2400W List of Commands File Check Utility OverviewOperation Operation MethodDownloading file from PC to PA-2400W Copy PC card Copying file with PC card from PA-2400W to PA-2400WTransmission side PA-2400W Describing Method 1Pathname Examples of Correct Startup Details about Command and OptionExamples of specification for command and option Example of Incorrect Startup no /G or /C optionCommand of Fchkce 1Generation of List File Comparison by List File Example \AP\MENU.EXE 12345 \CONFIG.SYS 1000 \AUTOEXEC.BAT 512Format of List File FILENO=3Syntax Analysis of Script File Childproccmd = COption = Recursiveoption Updateoption Recursiveoption = R Error Messages/Codes Restriction AO Append output Option /SCSpecification of a script file nameSpecification of recursive call File name list or Script file name\casio\ .dat \casio data\ \casio\ Destination directory nameFCHK.LOG file output directory name Fchkce /G /R \casio\ .dat \casio data\ \casio\FCHK.LOG file pathname Does not compare the update dataOption Fchkce /C \casio data\