PalmLaunchCodes.h

00001 /******************************************************************************
00002  * Copyright (c) 2005 palmOne, Inc. or its subsidiaries.
00003  * All rights reserved.
00004  *****************************************************************************/
00005 /** 
00006  *@ingroup System
00007  *
00008  */
00009  
00010 /**
00011  * @file    PalmLaunchCodes.h
00012  * @version 1.0
00013  * @date    03/20/2003
00014  *
00015  * @brief Device specific launch codes.
00016  * 
00017  *
00018  * <hr>
00019  */
00020 
00021 
00022 #ifndef __PALMLAUNCHCODES_H__
00023 #define __PALMLAUNCHCODES_H__
00024 
00025 #if defined(__arm__)
00026 #include "CmnLaunchCodes.h"
00027 #else
00028 #include "SystemMgr.h"
00029 #endif
00030  
00031 /**
00032  * @name Launch commands
00033  *
00034  */
00035 /*@{*/
00036 #define devAppLaunchCmdCustomBase       (sysAppLaunchCmdCustomBase + 1)     /**< Custom action code base */
00037 
00038 #define devAppLaunchCmdGenericCall      (devAppLaunchCmdCustomBase  + 1)    /**< Used when an application wants to launch another application, then to be re-launched when the service is finished */
00039 #define devAppLaunchCmdIncomingCall     (devAppLaunchCmdCustomBase  + 2)    /**<        */
00040 #define devAppLaunchCmdCallerId         (devAppLaunchCmdCustomBase  + 3)    /**<        */
00041 #define devAppLaunchCmdTelPowerOn       (devAppLaunchCmdCustomBase  + 4)    /**<        */
00042 #define devAppLaunchMyFavorite          (devAppLaunchCmdCustomBase  + 4)    /**<        */
00043 #define devAppLaunchCmdIncomingCallTest     (devAppLaunchCmdCustomBase  + 5)    /**<        */
00044 #define devAppLaunchCmdSliderOpened     (devAppLaunchCmdCustomBase  + 6)    /**<        */
00045 #define devAppLaunchCmdSliderClosed     (devAppLaunchCmdCustomBase  + 7)    /**<        */
00046 #define devAppLaunchLauncherDUBegin     (devAppLaunchCmdCustomBase  + 8)    /**<        */
00047 #define devAppLaunchLauncherDUEnd       (devAppLaunchCmdCustomBase  + 9)    /**<        */
00048 #define devAppLaunchLPCM_DUBegin        (devAppLaunchCmdCustomBase  + 10)   /**<        */
00049 #define devAppLaunchLPCM_DUEnd          (devAppLaunchCmdCustomBase  + 11)   /**<        */
00050 #define devAppLaunchWithCodeCheck       (devAppLaunchCmdCustomBase  + 12)   /**<        */
00051 #define sysAppLaunchCmdFromSetupApp     (devAppLaunchCmdCustomBase  + 13)   /**< Used to lock a Panel (panel cannot stop except with Done) */
00052 /*@}*/
00053 
00054 /**
00055  * Parameter blocks for action codes
00056  **/
00057 
00058 /**
00059  * @brief For devAppLaunchCmdGenericCall
00060  *
00061  **/
00062 typedef struct {
00063     UInt32  senderCreatorId;        /**< IN: the creator ID of the calling code resource */
00064     void*       userDataP;      /**< IN: pointer to custom data (optional) */
00065     UInt8       operation;      /**< IN: one of the sysAppLaunchGenericCallOp<operation> codes */
00066     UInt8       response;       /**< IN: set to 0; OUT: one of the sysAppLaunchGenericCallRet<response> codes, or 0 if not handled */
00067 } DevAppLaunchCmdGenericCallType;
00068 
00069 /**
00070  * @name Applicable operation code values:
00071  *
00072  */
00073 /*@{*/
00074 #define devAppLaunchGenericCallOpSubcall    ((UInt8)1)  /**< the sender wishes to launch the handler */
00075 #define devAppLaunchGenericCallOpExit       ((UInt8)2)  /**< the launched code resource replies that it won't launch the caller back */
00076 #define devAppLaunchGenericCallOpReturn     ((UInt8)3)  /**< the sub-call is finished, the launched code resource is ready to launch the caller back */
00077 #define devAppLaunchGenericCallOpCustomBase ((UInt8)0x80)   /**< custom operation code base (custom codes begin at this value) */
00078 /*@}*/
00079 
00080 /**
00081  * @name Applicable response code values:
00082  *
00083  */
00084 /*@{*/
00085 #define devAppLaunchGenericCallRetAccepted  ((UInt8)1)  /**< request accepted by the handler */
00086 #define devAppLaunchGenericCallRetRejected  ((UInt8)2)  /**< request rejected by the handler */
00087 /*@}*/
00088 
00089 
00090 #endif // __PALMLAUNCHCODES_H__
Top	Palm Developer Network © 2004-2008, Palm, Inc. All rights reserved. Generated on Fri Jun 13 10:06:54 2008 for Palm API Guide