PyObjCTools.AppHelper
– Work with AppKit¶
This module exports functions that are useful when working with the
AppKit
framework (or more generally, run loops).
- PyObjCTools.AppHelper.callAfter(func, *args, **kwargs) None ¶
Call function on the main thread. Returns immediately.
- Parameters:
func – The callable to invoke on the main thread.
*args – Positional arguments for func.
**kwds – Keyword arguments for func.
- PyObjCTools.AppHelper.callLater(delay, func, *args, **kwargs) None ¶
Call a function on the main thread after a delay. Returns immediately.
- Parameters:
delay – The delay in sectonds before invoking func
func – The callable to invoke on the main thread.
*args – Positional arguments for func.
**kwds – Keyword arguments for func.
- PyObjCTools.AppHelper.endSheetMethod(method) objc.selector ¶
Convert a method to a form that is suitable to use as the delegate callback for sheet methods.
- Parameters:
method – Callable with 3 arguments (the source object, return code and context)
- Returns:
Callable wrapped in a selector with the correct signature
- PyObjCTools.AppHelper.stopEventLoop() None ¶
Stops the event loop (if started by
runConsoleEventLoop()
) or sends theNSApplication
aterminate:
message.
- PyObjCTools.AppHelper.runConsoleEventLoop(argv=None, installInterrupt=False, mode=NSDefaultRunLoopMode, maxTimeout=3.0) None ¶
Run a
NSRunLoop
in a stoppable way (withstopEventLoop
).- Parameters:
argv – Program argument vector, defaults to
sys.argv
.installInterrupt – If true install a signal handler that will handle “CTRL+C”.
mode – The runloop mode
maxTimeout – The maximum delay between calling
stopEventLoop()
and actually stopping the run loop.
- PyObjCTools.AppHelper.runEventLoop(argv=None, unexpectedErrorAlert=None, installInterrupt=None, pdb=None, main=NSApplicationMain) None ¶
Run the event loop using
NSApplicationMain
and ask the user if we should continue if an exception is caught.Note
This function doesn’t return unless it throws an exception.
- Parameters:
argv – Program argument vector, defaults to
sys.argv
.unexpectedErrorAlert – Callable without arguments that will be invoked when uncaught exception is detected. Defaults to dropping into
pdb
when pdb is true and to showing an alert panel otherwise.installInterrupt – If true install a signal handler that will handle “CTRL+C”.
pdb – If true assume we’re running with a debugger, default is False unless “USE_PDB” is set in the environment
main – Main function to use, defaults to NSApplicationMain