Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
flash.text.engine 

GroupElement  - AS3

Packagesx

Niveau supérieur
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques
Packageflash.text.engine
Classepublic final class GroupElement
HéritageGroupElement Inheritance ContentElement Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Un objet GroupElement regroupe un ensemble d’objets TextElement, GraphicElement et d’autres objets GroupElement que vous pouvez affecter comme un tout à la propriété content d’un objet TextBlock. Un objet GroupElement peut aussi partager simplement une mise en forme commune au sein d’un autre objet GroupElement.

Lorsqu’un objet GroupElement contient un autre objet GroupElement, l’objet interne conserve sa propre mise en forme (paramètres ElementFormat). Il n’hérite pas de le formatage de l’objet GroupElement externe.

La plupart des propriétés de mise en forme n’affectent pas un objet GroupElement. De ce fait, il est possible de créer une ligne de texte pour un objet GroupElement avec un paramètre elementFormat nul. Quelques propriétés de mise en forme telles que kerning et ligature affectent le formatage lorsque des intersections apparaissent entre les membres du groupe. Si le groupe à un format null, le format de l’élément précédent détermine le formatage en présence de telles intersections.

Consulter les exemples

Plus d’exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  elementCount : int
[lecture seule] Nombre d’éléments dans le groupe.
GroupElement
 InheritedelementFormat : ElementFormat
Objet ElementFormat utilisé pour l’élément.
ContentElement
 InheritedeventMirror : EventDispatcher
Objet EventDispatcher qui reçoit des copies de chaque événement distribué pour valider les lignes de texte créées en fonction de cet élément de contenu.
ContentElement
 InheritedgroupElement : GroupElement
[lecture seule] Objet GroupElement contenant cet élément, ou null s’il ne fait pas partie d’un groupe.
ContentElement
 InheritedrawText : String
[lecture seule] Copie du texte dans l’élément, y compris les caractères U+FDEF.
ContentElement
 Inheritedtext : String
[lecture seule] Copie du texte dans l’élément, à l’exception des caractères U+FDEF représentant les éléments graphiques dans la chaîne.
ContentElement
 InheritedtextBlock : flash.text.engine:TextBlock
[lecture seule] TextBlock auquel appartient l’élément.
ContentElement
 InheritedtextBlockBeginIndex : int
[lecture seule] Index du premier caractère de cet élément dans le bloc de texte.
ContentElement
 InheritedtextRotation : String
Rotation à appliquer à l’élément en tant qu’unité.
ContentElement
 InheriteduserData : *
Permet à une application d’associer des données arbitraires à l’élément.
ContentElement
Méthodes publiques
 MéthodeDéfini par
  
GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Crée une nouvelle occurrence de GroupElement.
GroupElement
  
Récupère un élément dans le groupe.
GroupElement
  
Renvoie l’élément contenant le caractère spécifié par le paramètre charIndex.
GroupElement
  
Renvoie l’index de l’élément spécifié par le paramètre element.
GroupElement
  
groupElements(beginIndex:int, endIndex:int):GroupElement
Remplace la plage d’éléments que les paramètres beginIndex et endIndex spécifient par un nouveau GroupElement contenant ces éléments.
GroupElement
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
Fusionne le texte de la plage d’éléments spécifiés par les paramètres beginIndex et endIndex dans l’élément défini par beginIndex, sans affecter le formatage de cet élément.
GroupElement
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
Remplace la plage d’éléments que les paramètres beginIndex et endIndex spécifient par le contenu du paramètre newElements.
GroupElement
  
Définit les éléments du groupe sur le contenu du vecteur.
GroupElement
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
Scinde un objet TextElement en deux et crée un nouvel objet TextElement à la position spécifiée.
GroupElement
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
  
Annule le regroupement des éléments d’un GroupElement imbriqué que groupIndex spécifie au sein d’un objet GroupElement externe.
GroupElement
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

elementCount

propriété
elementCount:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Nombre d’éléments dans le groupe.



Implémentation
    public function get elementCount():int
Détails du constructeur

GroupElement

()Constructeur
public function GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Crée une nouvelle occurrence de GroupElement.

Paramètres
elements:Vector.<ContentElement> (default = null) — Vecteur d’objets ContentElement devant être contenus dans le GroupElement. Le vecteur peut être vide. La valeur par défaut est null.
 
elementFormat:ElementFormat (default = null) — Format des éléments du groupe. La valeur par défaut est null. Ce format s’applique aux intersections placées entre les éléments du groupe ; ces éléments n’héritent pas du format.
 
eventMirror:EventDispatcher (default = null) — Objet EventDispatcher qui reçoit des copies de chaque événement déclenché vers les lignes de texte créées en fonction de cet élément de contenu. La valeur par défaut est null.
 
textRotation:String (default = "rotate0") — Rotation appliquée à l’élément en tant qu’unité. Utilisez les constantes TextRotation pour cette propriété. La valeur par défaut est TextRotation.ROTATE_0.

Valeur émise
ArgumentError — L’élément spécifié contient des éléments null.
 
ArgumentError — L’élément spécifié contient un élément qui ne correspond à aucune sous-classe connue de ContentElement.
 
ArgumentError — L’élément spécifié contient des éléments définis en tant que content d’un TextBlock.
 
ArgumentError — L’élément spécifié contient des éléments appartenant déjà à un groupe, ou qui apparaissent plusieurs fois dans les éléments.

Eléments de l’API associés

Détails de la méthode

getElementAt

()méthode
public function getElementAt(index:int):ContentElement

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Récupère un élément dans le groupe.

Paramètres

index:int — Index de l’élément à récupérer.

Valeur renvoyée
ContentElement

Valeur émise
RangeError — si index est hors limites.

getElementAtCharIndex

()méthode 
public function getElementAtCharIndex(charIndex:int):ContentElement

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Renvoie l’élément contenant le caractère spécifié par le paramètre charIndex.

Paramètres

charIndex:int — Valeur d’index de base zéro du caractère dont vous recherchez l’élément. Une valeur 0 correspond au premier caractère du groupe, pas au premier caractère du TextBlock.

Valeur renvoyée
ContentElement — Elément contenant le caractère au niveau de charIndex

Valeur émise
RangeError — Si charIndex n’appartient pas à la plage 0 - rawText.length.

getElementIndex

()méthode 
public function getElementIndex(element:ContentElement):int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Renvoie l’index de l’élément spécifié par le paramètre element.

Paramètres

element:ContentElement — Elément du groupe dont vous souhaitez récupérer l’index.

Valeur renvoyée
int — Index de l’élément spécifié par element ou -1 si l’élément n’appartient pas au groupe.

groupElements

()méthode 
public function groupElements(beginIndex:int, endIndex:int):GroupElement

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Remplace la plage d’éléments que les paramètres beginIndex et endIndex spécifient par un nouveau GroupElement contenant ces éléments. Comme prévu, les éléments situés entre beginIndex et endIndex-1 sont remplacés.

Paramètres

beginIndex:int — Valeur d’index de base zéro de la position de départ de la plage à regrouper.
 
endIndex:int — Valeur d’index de base zéro suivant la position de fin de la plage à regrouper.

Valeur renvoyée
GroupElement — Nouveau groupe.

Valeur émise
RangeError — Si beginIndex ou endIndex est hors limites.

mergeTextElements

()méthode 
public function mergeTextElements(beginIndex:int, endIndex:int):flash.text.engine:TextElement

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Fusionne le texte de la plage d’éléments spécifiés par les paramètres beginIndex et endIndex dans l’élément défini par beginIndex, sans affecter le formatage de cet élément. Comme prévu, les éléments situés entre beginIndex et endIndex-1 sont fusionnés. Après la fusion de leur texte, les éléments compris entre beginIndex+1 et endIndex-1 son supprimés du groupe et deviennent orphelins, avec les propriétés group null.

Paramètres

beginIndex:int — Valeur d’index de base zéro de la position de départ de la plage à fusionner.
 
endIndex:int — Valeur d’index de base zéro suivant la position de fin de la plage à fusionner.

Valeur renvoyée
flash.text.engine:TextElement — Premier élément de texte de la plage, contenant à présent l’ensemble du texte de la plage.

Valeur émise
RangeError — Si beginIndex ou endIndex est hors limites.
 
ArgumentError — Si l’un des éléments de la plage spécifiée n’est pas un TextElement.

Eléments de l’API associés

replaceElements

()méthode 
public function replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Remplace la plage d’éléments que les paramètres beginIndex et endIndex spécifient par le contenu du paramètre newElements. Les éléments situés entre beginIndex et endIndex-1 sont remplacés.

Pour supprimer des éléments, transmettez null pour newElements. Pour insérer un élément, transmettez la même valeur pour beginIndex et endIndex. Le nouvel élément est inséré avant l’index spécifié. Pour ajouter un élément, transmettez elementCount pour beginIndex et endIndex.

Après l’opération, les éléments remplacés sont orphelins, avec des propriétés group null, puis sont renvoyés.

Paramètres

beginIndex:int — Valeur d’index de base zéro pour la position de début de la plage de remplacement.
 
endIndex:int — Valeur d’index de base zéro suivant la position de fin de la plage de remplacement.
 
newElements:Vector.<ContentElement> — Eléments à utiliser pour remplacer la plage d’éléments spécifiée.

Valeur renvoyée
Vector.<ContentElement> — Vecteur contenant les éléments qui ont été remplacés.

Valeur émise
RangeError — La valeur beginIndex ou endIndex est hors limite.
 
ArgumentError — Les newElements spécifiés contiennent des éléments null.
 
ArgumentError — Les newElements spécifiés contiennent this.
 
ArgumentError — Les newElements spécifiés contiennent des éléments qui ne correspondent pas à une sous-classe connue de ContentElement.
 
ArgumentError — Les newElements spécifiés contiennent des éléments définis en tant que content d’un TextBlock.
 
ArgumentError — Les newElements spécifiés contiennent des éléments appartenant déjà à un groupe, ou qui apparaissent plusieurs fois dans les éléments.
 
ArgumentError — Si l’opération résulte en rotations imbriquées dans GroupElement.

setElements

()méthode 
public function setElements(value:Vector.<ContentElement>):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Définit les éléments du groupe sur le contenu du vecteur.

Paramètres

value:Vector.<ContentElement>


Valeur émise
ArgumentError — La valeur spécifiée contient des éléments null.
 
ArgumentError — La valeur spécifiée contient this.
 
ArgumentError — La valeur spécifiée contient des éléments qui ne correspondent pas à une sous-classe connue de ContentElement.
 
ArgumentError — La valeur spécifiée contient des éléments spécifiés en tant que content d’un TextBlock.
 
ArgumentError — La valeur spécifiée contient des éléments appartenant déjà à un groupe, ou qui apparaissent plusieurs fois dans la valeur.
 
ArgumentError — Si l’opération résulte en rotations imbriquées dans GroupElement.

splitTextElement

()méthode 
public function splitTextElement(elementIndex:int, splitIndex:int):flash.text.engine:TextElement

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Scinde un objet TextElement en deux et crée un nouvel objet TextElement à la position spécifiée.

Paramètres

elementIndex:int — Valeur d’index de base zéro de la position de l’élément dans le groupe.
 
splitIndex:int — Valeur d’index de base zéro du caractère dans le TextElement où se produit la division. Le caractère spécifié est le premier caractère du nouveau TextElement.

Valeur renvoyée
flash.text.engine:TextElement — Nouvel élément de texte contenant la dernière partie de l’élément de texte d’origine.

Valeur émise
RangeError — Si elementIndex ou charIndex est hors limites.
 
ArgumentError — Si l’élément au niveau de elementIndex n’est pas un TextElement.

Eléments de l’API associés

ungroupElements

()méthode 
public function ungroupElements(groupIndex:int):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Annule le regroupement des éléments d’un GroupElement imbriqué que groupIndex spécifie au sein d’un objet GroupElement externe. Après l’opération, les éléments dégroupés remplacent le GroupElement imbriqué, qui devient un orphelin avec une propriété group null.

Paramètres

groupIndex:int — Valeur d’index de base zéro de la position du groupe à diviser.


Valeur émise
RangeError — Si groupIndex est hors limites.
 
ArgumentError — Si l’élément au niveau de groupIndex n’est pas un objet GroupElement.
GroupElementExample.as

Cet exemple crée une case rouge sous la forme d’un objet GraphicElement et la combine à deux objets TextElement pour créer un objet GroupElement. Il affecte l’objet GroupElement à la propriété content d’un TextBlock, à partir duquel il crée trois lignes.
package {

    import flash.display.Sprite;
    import flash.display.MovieClip;
    import flash.text.engine.ContentElement;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.GraphicElement;
    import flash.text.engine.GroupElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    
    public class GroupElementExample extends Sprite {
        
        public function GroupElementExample():void {
            
            var redBox:MovieClip = new MovieClip();
            redBox.graphics.beginFill(0xCC0000, 1.0);
            redBox.graphics.drawRect(0, 0, 20, 20);
            redBox.graphics.endFill(); 
            
            var format:ElementFormat = new ElementFormat();
            var fontDescription:FontDescription = new FontDescription("Arial");
            format.fontSize = 16;
            format.fontDescription = fontDescription;
            
            var str1:String = "This red box is a GraphicElement ";
            var str2:String = " in the middle of two TextElements, " +
            " which together make " +
            "up a GroupElement in a TextBlock that is broken into three lines.";
            
            var textElement1:TextElement = new TextElement(str1,format);
            var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format);
            var textElement2:TextElement = new TextElement(str2, format);
            var groupVector:Vector.<ContentElement> = new Vector.<ContentElement>();
            groupVector.push(textElement1, graphicElement, textElement2);
            var groupElement = new GroupElement(groupVector);
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = groupElement;
            createTextLines(textBlock);
        }
        
        private function createTextLines(textBlock:TextBlock):void 
        {
        
            var yPos = 20;
            var line_length:Number = 450;
            var textLine:TextLine = textBlock.createTextLine (null, line_length);
 
            while (textLine)
            {
                addChild(textLine);
                textLine.x = 15;
                yPos += textLine.height+8;
                textLine.y = yPos;
                textLine = textBlock.createTextLine(textLine, line_length);
            }
        }
    }    
}






[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.