on appevent statement

	<< Index >>	FutureBasic
on appevent		statement

Syntax
on appevent fn userFunction

Description
This statement designates a particular function as an application event handling routine. An application event handling function is called in response to a variety of application notifications.

Note
If you use on appevent fn userFunction, then userFunction must refer to a function which was defined or prototyped at an earlier location in the source code. Your application event handling function should not return a result.

Example

This example assumes an application event handling function has been designated with the name "DoAppEvent" via a "on appevent fn DoAppEvent".

void local fn DoAppEvent( ev as long, obj as CFTypeRef )


	select ( ev )

	
		case _appWillFinishLaunching

		
			... do something

		
		case _appShouldTerminateAfterLastWindowClosed

		
			AppEventSetBool(YES)

		
	
	end select


end fn

App events
_appWillFinishLaunching
_appDidFinishLaunching
_appShouldTerminate
_appShouldTerminateAfterLastWindowClosed
_appWillTerminate
_appWillBecomeActive
_appDidBecomeActive
_appWillResignActive
_appDidResignActive
_appWillHide
_appDidHide
_appWillUnhide
_appDidUnhide
_appWillUpdate
_appDidUpdate
_appShouldHandleReopen
_appDockMenu
_appWillPresentError
_appDidChangeScreenParameters
_appOpenFileWithoutUI
_appOpenTempFile
_appOpenFiles
_appOpenUntitledFile
_appShouldOpenUntitledFile
_appPrintFile
_appPrintFiles
_appDidRegisterForRemoteNotificationsWithDeviceToken
_appDidFailToRegisterForRemoteNotifications
_appDidReceiveRemoteNotification
_appDidDecodeRestorableState
_appWillEncodeRestorableState
_appWillContinueUserActivityWithType
_appContinueUserActivity
_appDidFailToContinueUserActivityWithType
_appDidUpdateUserActivity
_appDidChangeOcclusionState
_appOpenURLs

App event functions


AppEventSetBool( BOOL value )

AppEventSetLong( long value )

AppEventString = CFStringRef

AppEventArray = CFArrayRef

AppEventDictionary = CFDictionaryRef

AppEventURL = CFURLRef

AppEventSetMenu( MenuRef m )

Apple documentation
NSApplicationDelegate