Variables globales, Constantes, et Types prédéfinis

Cette section liste les variables globales, les constantes, et les types prédéfinis du Kit d'Application. Les codes d'erreurs sont documentés dans le chapitre consacré au Kit de Support.

Bien que le Kit d'Application manipule les constantes de tous les messages système (tel que B_REFS_RECEIVED et B_KEY_DOWN), seules celles gérées par les objets du kit sont traitées ici. Celles qui concernent les messages d'interface sont documentées dans le chapitre consacré au Kit d'interface.

Variables Globales

be_app

Déclaré dans : be/app/Application.h

	BApplication *be_app

Cette variable procure un accès global à l'objet BApplication. Elle est initialisée par le constructeur BApplication.

Voir aussi : la classe BApplication.

be_app_messenger

Déclaré dans : be/app/Application.h

	BMessenger *be_app_messenger

Cette variable procure un accès global à l'objet BMessenger dont la cible est be_app. Elle est initialisée par le constructeur BApplication.

Voir aussi : la classe BApplication.

be_clipboard

Déclaré dans : be/app/Clipboard.h

	BClipboard *be_clipboard

Cette variable donne aux applications l'accès au presse-papier système — le dépositaire partagé des données pour les opérations de couper, copier et coller. Elle est initialisée au démarrage du système.

Voir aussi : la classe BClipboard.

be_roster

Déclaré dans : be/app/Roster.h

	const BRoster *be_roster

Cette variable pointe sur l'objet global BRoster de l'application. Le BRoster garde la liste de toute les applications actives et peut ajouter des applications à la liste en les lançant. Elle est initialisée au démarrage de l'application.

Voir aussi : la classe BRoster.

Constantes

Flags d'application

Déclaré dans : be/app/Roster.h

Constante
B_BACKGROUND_APP
B_ARGV_ONLY
B_LAUNCH_MASK

Ces constantes sont utilisées pour obtenir des informations du champ flags, contenu dans une structure app_info.

Voir aussi : BRoster::GetAppInfo(), "Constantes de lancement" ci-après.

Messages d'application

Déclaré dans : be/app/AppDefs.h

Constante
B_QUIT_REQUESTED
B_READY_TO_RUN
B_APP_ACTIVATED
B_ABOUT_REQUESTED
B_QUIT_REQUESTED
B_ARGV_RECEIVED
B_REFS_RECEIVED
B_PULSE

Ces constantes représentent les messages système reconnus et traités spécifiquement par les répartiteurs BApplication et BLooper. Les messages d'application concernent l'application dans son entier, plutôt que le thread d'une fenêtre particulière. Voir l'introduction à ce chapitre et la classe BApplication pour les details.

Voir aussi : "Messages d'application" à la page 30 de la classe BApplication.

Constantes de pointeur de souris

Déclaré dans : be/app/AppDefs.h

	const unsigned char B_HAND_CURSOR [] const unsigned char B_I_BEAM_CURSOR []

Ces constantes contiennent toutes les données nécessaires pour afficher le pointeur (de souris) par défaut - "la main", ou le pointeur standard "I" pour sélectionner du texte.

Voir aussi : BApplication::SetCursor().

Constantes de résultat de filtres

Déclaré dans : be/app/MessageFilter.h

Constante
B_SKIP_MESSAGE
B_DISPATCH_MESSAGE

Ces constantes listent les valeurs de retour possibles d'une fonction filtre.

Voir aussi : BMessageFilter::Filter().

Constantes de lancement

Déclaré dans : be/app/Roster.h

Constante
B_MULTIPLE_LAUNCH
B_SINGLE_LAUNCH
B_EXCLUSIVE_LAUNCH

Ces constantes définissent si une application peut être lancée un nombre quelconque de fois, ou une fois seulement à partir d'un exécutable particulier ou d'une signature d'application spécifique. Ces informations font partie du champ flags, contenu dans une structure app_info. Elles peuvent en être extraites en utilisant la constante B_LAUNCH_MASK.

Voir aussi : BRoster::GetAppInfo(), "Flags d'application" ci-dessus.

Capacité du port de Looper

Déclaré dans : be/app/Looper.h

Constante
B_LOOPER_PORT_DEFAULT_CAPACITY

Cette constante enregistre la capacité par défaut d'un port de BLooper. 100 emplacements (slots) représente la valeur par défaut ; un nombre plus petit ou plus grand peut être spécifié lors de la construction du BLooper.

Voir aussi : le constructeur BLooper.

Constantes de message

Déclaré dans : be/app/AppDefs.h

Constante
B_REPLY
B_NO_REPLY
B_MESSAGE_NOT_UNDERSTOOD
B_SAVE_REQUESTED
B_CANCEL
B_SIMPLE_DATA
B_MIME_DATA
B_ARCHIVED_OBJECT
B_UPDATE_STATUS_BAR
B_RESET_STATUS_BAR
B_NODE_MONITOR
B_QUERY_UPDATE
B_CUT
B_COPY
B_PASTE
B_SELECT_ALL
B_SET_PROPERTY
B_GET_PROPERTY
B_CREATE_PROPERTY
B_DELETE_PROPERTY
B_GET_SUPPORTED_SUITES

Ces constantes marquent des messages que le système place parfois ensemble, mais qui ne sont pas délivrés comme des messages système. Voir "Messages Standard" dans l'annexe Protocoles de message pour les détails.

Voir aussi : BMessage::SendReply(), la classe BTextView dans le Kit d'interface.

Constantes de délivrance de messages

Déclaré dans : be/app/MessageFilter.h

Constante
B_ANY_DELIVERY
B_DROPPED_DELIVERY
B_PROGRAMMED_DELIVERY

Ces constantes précisent le critère de délivrance pour filtrer un BMessage.

Voir aussi : le constructeur BMessageFilter.

Constantes des sources de message

Déclaré dans : be/app/MessageFilter.h

Constante
B_ANY_SOURCE
B_REMOTE_SOURCE
B_LOCAL_SOURCE

Ces constantes listent les contraintes possibles qu'un BMessageFilter peut imposer à la source des messages qu'il filtre.

Voir aussi : le constructeur BMessageFilter.

Spécifieurs de messages

Déclaré dans : be/app/Message.h

Constante
B_NO_SPECIFIER
B_DIRECT_SPECIFIER
B_INDEX_SPECIFIER
B_REVERSE_INDEX_SPECIFIER
B_RANGE_SPECIFIER
B_REVERSE_RANGE_SPECIFIER
B_NAME_SPECIFIER
B_ID_SPECIFIER
B_SPECIFIERS_END  = 128

Ces constantes remplissent l'emplacement (slot) what des spécifieurs BMessages. Chaque constante indique quelles autres informations sont contenues dans le spécifieur et comment elles doivent être interprêtées. Par exemple, un message B_REVERSE_INDEX_SPECIFIER contient un champ "index", et un index inverse, débutant à partir de la fin d'une liste. Un message B_NAME_SPECIFIER inclut un champ "nom" désignant l'élément requis.

Types Pré-définis

app_info

Déclaré dans : be/app/Roster.h

	typedef struct {          thread_id thread;          team_id team;          port_id port;          uint32 flags;          entry_ref ref;          char signature[B_MIME_TYPE_LENGTH];          app_info(void);          ~app_info(void);       } app_info

Cette structure est utilisée par les fonctions GetAppInfo(), GetRunningAppInfo(), et GetActiveAppInfo() de BRoster pour ramener des informations sur une application. Son constructeur garantit que les champs sont initialisés par des valeurs invalides. Pour récupérer les bonnes valeurs d'une application active, il faut passer la structure à une des fonctions de BRoster .. Voir ces fonctions pour une description des divers champs.

Voir aussi : BRoster::GetAppInfo()

filter_result

Déclaré dans : be/app/MessageFilter.h

	typedef enum { . . . } filter_result

Ce type fait la distinction entre les valeurs de retour B_SKIP_MESSAGE et B_DISPATCH_MESSAGE d'une fonction filtre.

Voir aussi : BMessageFilter::Filter()

message_delivery

Déclaré dans : be/app/MessageFilter.h

	typedef enum { . . . } message_delivery

Ce type énumère les critères de délivrance pour filter un message.

Voir aussi : le constructeur BMessageFilter.

message_source

Déclaré dans : be/app/MessageFilter.h

	typedef enum { . . . } message_source

Ce type énumère les critères de source pour filtrer un message.

Voir aussi : the BMessageFilter constructor