Availability: Macintosh.
Este módulo proporciona acceso a la funcionalidad específica de MacOS
del intérprete de Python, como las funciones de bucle de eventos de
intérprete y similares. Se debe usar con cuidado.
Obsérvese las mayúsculas en el nombre del módulo, es un deje histórico.
- Error
-
Esta excepción se lanza en los errores generados por el MacOS,
tanto por funciones de este módulo como de otros módulos específicos
de Mac, como las interfaces a la caja de herramientas. Los argumentos
son el código de error entero (el valor OSErr) y una descripción
textual del código de error. Los nombres simbólicos de los códigos de error
conocidos están definidos en el módulo estándar
macerrors.
- SetEventHandler (handler)
-
En el bucle del intérprete interno Python verificará si hay eventos ocasionalmente,
salvo que se desactive esto con ScheduleParams(). Con esta función
se puede pasar una función gestora de eventos en Python para los eventos disponibles.
Se pasa el evento como parámetro. La función debe devolver un valor no nulo
si el evento ha sido completamente procesado; en caso contrario, continúa
el procesado (por ejemplo, pasando el evento al paquete de ventana de consola).
Llamando a SetEventHandler() sin parámetro se libera el gestor
de eventos. Se causa un error si se pone un gestor de eventos si ya hay uno puesto.
- SchedParams ([doint[, evtmask[,
besocial[, interval[,
bgyield]]]]])
-
Incluir en la gestión de eventos del intérprete interior. Interval
especifica la frecuencia (en segundos, valor de coma flotante) con la que el
intérprete debe entrar en el código de proceso. Si tiene un valor no nulo, doint
activa el procesado de la interrupción (Comando-punto). evtmask
indica al intérprete que realice procesado de eventos de la máscara (redibujados,
clics para cambiar a otras aplicaciones, etc.). El indicador besocial otorga
a otros procesos la oportunidad de ejecutarse. Se les otorga un tiempo de ejecución mínimo
cuando Python está en primer plano y bgyield segundos cada interval
cuando Python está en segundo plano.
Todos los parámetros son opcionales, siendo su valor por omisión el valor
actual. El valor devuelto por la función es una tupla con los valores anteriores
de tales opciones. Los valores iniciales absolutos son: Activado todo el proceso,
se comprueba cada 0,25 segundos y se libera la CPU 0,25 segundos en segundo plano.
- HandleEvent (ev)
-
Devuelve el bloque de eventos ev al bucle de eventos de Python
o, posiblemente, al gestor de la ventana
sys.stdout (según el compilador
utilizado para compilar Python). Esto permite que los programas en Python
que realizan su propia gestión de eventos mantengan cierta funcionalidad de
interrupción (comando-punto) y cambio de ventanas.
Si se intenta llamar a esta función desde un gestor de eventos puesto
mediante SetEventHandler() saltará una excepción.
- GetErrorString (errno)
-
Devuelve la descripción textual del código de error MacOS errno.
- splash (resid)
-
Esta función sacará una pantalla de presentación con el contenido del recurso
DLOG especificado por resid. Si se llama con un argumento cero, se retira
la pantalla de presentación. Esta función es útil si se desea que un applet muestre
un a pantalla de presentación inmediatamente, sin esperar a cargar módulos de extensión.
- DebugStr (message [, object])
-
Caer al depurador de bajo nivel con el mensaje message. El
argumento object no se usa, pero es fácil de inspeccionar
desde el depurador.
Obsérvese que hay que llamar a esta función con un cuidado extremo: Si
no hay un depurador de bajo nivel, como MacsBug, instalado, está llamada
hará que el sistema se cuelgue. Esta llamada está dirigida, sobre todo, a desarrolladores
de módulos de extensión de Python.
- openrf (name [, mode])
-
Abrir la horquilla de recursos de un fichero. Los argumentos son los mismos
que los de la función interna open(). El objeto devuelto tiene una
semántica similar a la de los ficheros, pero no es un objeto fichero de Python, por lo
que puede haber sutiles diferencias.
Ver Sobre este documento... para obtener información sobre sugerencias.
