System  - AS3

Quantité de mémoire (en octets) qui n’est pas allouée à Adobe^® Flash^® Player ou Adobe^® AIR^® et qui n’est pas en cours d’utilisation. Cette portion de mémoire allouée non utilisée (System.totalMemory) fluctue à chaque nettoyage de la mémoire. Utilisez cette propriété pour gérer le nettoyage de la mémoire.

Eléments de l’API associés

L’IME système installé. Pour s’inscrire aux événements imeComposition, appelez addEventListener() sur cette occurrence.

Plus d’exemples

Eléments de l’API associés

Quantité totale de mémoire (en octets) utilisée par une application. Il s’agit de la quantité de mémoire privée résidente pour l’ensemble du processus.

Les développeurs AIR doivent utiliser cette propriété pour déterminer la consommation totale de mémoire d’une application.

Pour Flash Player, cela comprend la mémoire utilisée par l’application conteneur, telle que le navigateur Web.

Eléments de l’API associés

Quantité de mémoire (en octets) actuellement utilisée ayant été directement allouée par Flash Player ou AIR.

Cette propriété ne renvoie pas toute la mémoire utilisée par une application Adobe AIR ou par l’application (par exemple, un navigateur) englobant le contenu de Flash Player. Le navigateur ou le système d’exploitation peut utiliser d’autres ressources mémoire. La propriété System.privateMemory indique toute la mémoire utilisée par une application.

Si la quantité de mémoire allouée est supérieure à la valeur maximale d’un objet uint (uint.MAX_VALUE; soit 4 294 967 295), cette propriété est définie sur 0. La propriété System.totalMemoryNumber prend en charge des valeurs supérieures.

Plus d’exemples

Eléments de l’API associés

Quantité de mémoire (en octets) actuellement utilisée ayant été directement allouée par Flash Player ou AIR.

Cette propriété, exprimée sous forme de nombre, prend en charge des valeurs plus élevées que la propriété System.totalMemory, qui est de type int.

Cette propriété ne renvoie pas toute la mémoire utilisée par une application Adobe AIR ou par l’application (par exemple, un navigateur) englobant le contenu de Flash Player. Le navigateur ou le système d’exploitation peut utiliser d’autres ressources mémoire. La propriété System.privateMemory indique toute la mémoire utilisée par une application.

Eléments de l’API associés

Une valeur booléenne qui indique la page de code à utiliser pour interpréter des fichiers texte externes. Lorsque la propriété est définie sur false, les fichiers texte externes sont interprétés comme de l’Unicode (ces fichiers doivent être codés en Unicode lorsque vous les enregistrez). Lorsque la propriété est définie sur true, les fichiers texte externes sont interprétés à l’aide de la page de code classique du système d’exploitation exécutant l’application. La valeur par défaut de useCodePage est false.

Le texte que vous chargez comme fichier externe (à l’aide de Loader.load(), la classe URLLoader ou URLStream) doit avoir été enregistré comme de l’Unicode pour que l’application le reconnaisse comme tel. Pour coder des fichiers externes comme de l’Unicode, enregistrez les fichiers dans une application qui prend en charge l’Unicode, tel que Notepad sous Windows.

Si vous chargez des fichiers externes qui ne sont pas codés en Unicode, définissez useCodePage sur true. Ajoutez le code suivant sur la première ligne de code du fichier qui charge les données (pour Flash Professional, ajoutez-le à la première image) :

System.useCodePage = true;

Lorsque ce code est présent, l’application interprète le texte externe à l’aide de la page de code classique du système d’exploitation. Par exemple, ce code est généralement CP1252 pour un système d’exploitation Windows anglais et Shift-JIS pour un système d’exploitation japonais.

Si vous définissez useCodePage sur true, Flash Player 6 et les versions ultérieures traitent le texte comme Flash Player 5 (Flash Player 5 traitait l’ensemble du texte comme s’il se trouvait dans la page de code classique du système d’exploitation exécutant le lecteur).

Si vous définissez useCodePage sur true, souvenez-vous que la page de code classique du système d’exploitation exécutant l’application doit inclure les caractères utilisés dans votre fichier de texte externe afin d’afficher le texte. Par exemple, si vous chargez un fichier texte externe contenant des caractères chinois, ceux-ci ne peuvent s’afficher sur un système utilisant la page de code CP1252 car celle-ci ne comprend pas les caractères chinois.

Pour que les utilisateurs de toutes les plates-formes puissent afficher les fichiers de texte externes utilisés dans votre application, vous devez coder tous les fichiers de texte externes en Unicode et conserver la propriété useCodePage définie sur false par défaut. Ainsi, l’application (Flash Player 6 et les versions ultérieures ou AIR) interprète le texte comme Unicode.

Plus d’exemples

Eléments de l’API associés

Rend l’objet XML spécifié immédiatement disponible à des fins de nettoyage. Cette méthode supprime les connexions parent et enfant entre tous les nœuds pour le nœud XML spécifié.

Paramètres

Ferme Flash Player.

Pour la version débogueur de Flash Player autonome uniquement.

Les applications AIR doivent appeler la méthode NativeApplication.exit() pour quitter l’application.

Paramètres

Eléments de l’API associés

Impose le processus de nettoyage de la mémoire.

Pour la version débogueur de Flash Player et des applications AIR uniquement. Dans une application AIR, la méthode System.gc() est activée uniquement dans le contenu s’exécutant dans l’application de débogage du lanceur AIR (ADL) ou, dans une application installée, dans le contenu du sandbox de sécurité de l’application.

Interrompt Flash Player ou l’application de débogage du lanceur AIR. Après avoir appelé cette méthode, l’application cesse toute activité, sauf la distribution des événements Socket.

Pour la version débogueur de Flash Player ou l’application de débogage du lanceur AIR.

Eléments de l’API associés

Indiquez au nettoyeur de mémoire que si l’imminence du nettoyeur dépasse le paramètre imminence de la fonction, il devra terminer le cycle de nettoyage incrémentiel.

L’algorithme du nettoyeur de mémoire du moteur d’exécution de Flash s’exécute par incréments tout en signalant la mémoire en cours d’utilisation. Il interrompt l’exécution de l’application lors du nettoyage des portions de mémoire inutilisées. Cette interruption se produit lorsque le cycle de nettoyage incrémentiel peut être plus long que prévu et peut être observable ou audible dans certains programmes. Cette fonction permet à l’application d’informer le moteur d’exécution qu’il est temps de terminer le marquage et d’effectuer le nettoyage. La planification des interruptions potentielles dans les cas où l’utilisateur ne les remarque pas permet d’optimiser l’expérience utilisateur. Par exemple, un jeu peut appeler cette fonction après l’achèvement d’un niveau, réduisant ainsi les chances d’une interruption survenant pendant le jeu.

L’imminence est définie comme la distance qui sépare le nettoyeur du marquage, et donc comme le moment de déclencher une interruption de nettoyage. L’argument d’imminence à cette fonction est un seuil : le nettoyeur de mémoire sera appelé uniquement si l’imminence actuelle dépasse la valeur seuil. Dans le cas contraire, cet appel est immédiatement renvoyé sans aucune action.

Si vous appelez cette fonction avec une faible valeur d’imminence, l’application indique qu’elle autorise l’achèvement d’une quantité relativement importante de marquage. En revanche, une valeur d’imminence élevée indique que l’application doit être mise en pause uniquement si le marquage est presque terminé.  En règle générale, les pauses sont plus longues dans le premier cas de figure.

La quantité de mémoire libérée ne dépend pas du paramètre d’imminence. Elle dépend uniquement du nombre d’objets pouvant être libérés. Si l’application a récemment libéré des références à de grandes structures de données ou à un grand nombre d’objets, un faible paramètre d’imminence aura tendance à déclencher une collection qui libérera ces objets immédiatement.

Paramètres

Redémarre l’application après avoir appelé System.pause().

Pour la version débogueur de Flash Player ou l’application de débogage du lanceur AIR.

Eléments de l’API associés

Remplace le contenu du presse-papiers par une chaîne de texte spécifiée. Cette méthode fonctionne à partir de n’importe quel contexte de sécurité lorsqu’elle est appelée suite à un événement utilisateur (événement de clavier ou de périphérique de saisie, par exemple).

Cette méthode est fournie pour le contenu SWF s’exécutant dans Flash Player 9. Elle permet uniquement d’ajouter le contenu de la chaîne au Presse-papiers.

Le contenu de Flash Player 10 et le contenu dans le sandbox de sécurité de l’application d’une application AIR peuvent appeler la méthode Clipboard.setData().

Paramètres

Plus d’exemples

Eléments de l’API associés