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 

ElementFormat  - 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 ElementFormat
HéritageElementFormat Inheritance Object

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

La classe ElementFormat représente les informations de formatage pouvant être appliquées à un objet ContentElement. Utilisez la classe ElementFormat pour créer une mise en forme de texte spécifique pour les différentes sous-classes de ContentElement. Les propriétés de la classe ElementFormat s’appliquent aux polices de périphérique et intégrées.

Un objet ElementFormat appliqué à un ContentElement dans un TextBlock n’invalide pas le TextBlock. Après avoir appliqué un objet ElementFormat à un ContentElement, sa propriété locked est définie sur true. Les propriétés d’un objet ElementFormat bloqué ne peuvent pas être modifiées. Utilisez plutôt la méthode clone() pour créer une copie non verrouillée de l’objet, qu’il est possible de modifier et d’affecter au ContentElement.

Consulter les exemples

Plus d’exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  alignmentBaseline : String
Spécifie le type de ligne de base dans l’élément contenant avec lequel sont alignées les lignes de base des éléments possédant ce format.
ElementFormat
  alpha : Number
Spécifie la transparence des éléments de ligne affectés par cet objet.
ElementFormat
  baselineShift : Number
Indique le décalage de la ligne de base pour l’élément, en pixels.
ElementFormat
  breakOpportunity : String
Opportunité de saut de ligne appliquée à ce texte.
ElementFormat
  color : uint
Indique la couleur du texte.
ElementFormat
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  digitCase : String
Casse de chiffres utilisée pour ce texte.
ElementFormat
  digitWidth : String
Largeur de chiffres utilisée pour ce texte.
ElementFormat
  dominantBaseline : String
Spécifie le type de ligne de base à utiliser comme ligne de base dominante.
ElementFormat
  fontDescription : FontDescription
Objet dont les propriétés décrivent une police.
ElementFormat
  fontSize : Number
La taille du texte, en pixels.
ElementFormat
  kerning : String
Le crènage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité.
ElementFormat
  ligatureLevel : String
Niveau de ligature utilisé pour ce texte.
ElementFormat
  locale : String
Variable locale du texte.
ElementFormat
  locked : Boolean
Indique si l’objet ElementFormat est bloqué.
ElementFormat
  textRotation : String
Définit la rotation appliquée aux glyphes individuelles.
ElementFormat
  trackingLeft : Number
Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels.
ElementFormat
  trackingRight : Number
Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels.
ElementFormat
  typographicCase : String
Casse typographique utilisée pour ce texte.
ElementFormat
Méthodes publiques
 MéthodeDéfini par
  
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Crée un objet ElementFormat.
ElementFormat
  
Crée une copie non verrouillée et clonée de l’objet ElementFormat.
ElementFormat
  
Renvoie un objet FontMetrics avec des propriétés qui décrivent la valeur emBox, la position et l’épaisseur du barré et du soulignement pour la police spécifiée par fontDescription et fontSize.
ElementFormat
 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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 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
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

alignmentBaseline

propriété
alignmentBaseline:String

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

Spécifie le type de ligne de base dans l’élément contenant avec lequel sont alignées les lignes de base des éléments possédant ce format. Utilisez les constantesTextBaseline pour cette propriété.

Le plus grand élément vertical de la ligne détermine l’alignement des lignes de base, sauf si TextBlock.baselineFontDescription et TextBlock.baselineFontSize sont définis pour un autre comportement.

La valeur par défaut est TextBaseline.USE_DOMINANT_BASELINE.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
TextBaseline.ROMANLa dominantBaseline s’aligne sur la ligne de base des caractères romains de la ligne.
TextBaseline.ASCENTLa dominantBaseline s’aligne sur la ligne de base des caractères ascendants de la ligne.
TextBaseline.DESCENTLa dominantBaseline s’aligne sur la ligne de base des caractères descendants de la ligne.
TextBaseline.IDEOGRAPHIC_TOPLa dominantBaseline s’aligne sur la ligne de base du haut des caractères idéographiques de la ligne.
TextBaseline.IDEOGRAPHIC_CENTERLa dominantBaseline s’aligne sur la ligne de base du centre des caractères idéographiques de la ligne.
TextBaseline.IDEOGRAPHIC_BOTTOMLa dominantBaseline s’aligne sur la ligne de base du bas des caractères idéographiques de la ligne.
TextBaseline.USE_DOMINANT_BASELINELa dominantBaseline s’aligne sur la même ligne de base de la ligne.

Sous-classeEffet de la définition des propriétés
GraphicElementDéfinit la ligne de base de l’alignement de la ligne sur celle sur laquelle s’aligne la dominantBaseline de l’élément graphique.
GroupElementN’a aucun effet.
TextElementDéfinit la ligne de base de l’alignement de la ligne sur celle sur laquelle s’aligne la dominantBaseline de l’élément de texte.



Implémentation
    public function get alignmentBaseline():String
    public function set alignmentBaseline(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextBaseline.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

alpha

propriété 
alpha:Number

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

Spécifie la transparence des éléments de ligne affectés par cet objet. Les valeurs disponibles sont comprises entre 0 (entièrement transparent) et 1 (entièrement opaque). Les objets d’affichage où alpha est défini sur 0 sont actifs, même s’ils sont invisibles.

La valeur par défaut est 1.

Sous-classeEffet de la définition des propriétés
GraphicElementApplique l’alpha spécifié à l’élément graphique. Fait une combinaison par multiplication avec tout alpha défini sur le graphique DisplayObject lui-même ou sur la TextLine.
GroupElementN’a aucun effet.
TextElementApplique l’alpha spécifié à l’élément de texte. Fait une combinaison par multiplication avec tout alpha défini sur la TextLine.



Implémentation
    public function get alpha():Number
    public function set alpha(value:Number):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

baselineShift

propriété 
baselineShift:Number

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

Indique le décalage de la ligne de base pour l’élément, en pixels.

L’élément est éloigné d’autant de la dominantBaseline. Le décalage étant ajouté à la position y des membres de l’élément, dans un texte qui ne pivote pas, un décalage de ligne de base positif déplace l’élément vers le bas et un décalage de ligne de base négatif déplace l’élément vers le haut.

La valeur par défaut est 0.0, ce qui signifie aucun décalage.

Sous-classeEffet de la définition des propriétés
GraphicElementEloigne le graphique de la ligne de base.
GroupElementN’a aucun effet.
TextElementEloigne le texte de la ligne de base.



Implémentation
    public function get baselineShift():Number
    public function set baselineShift(value:Number):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

breakOpportunity

propriété 
breakOpportunity:String

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

Opportunité de saut de ligne appliquée à ce texte. Cette propriété détermine quels caractères peuvent être utilisés pour effectuer un saut de ligne lorsque le texte est scindé en plusieurs lignes. Utilisez les constantes BreakOpportunity pour cette propriété.

La valeur par défaut est BreakOpportunity.AUTO.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
BreakOpportunity.AUTOLes possibilités de saut de ligne sont basées sur les propriétés des caractères Unicode standard, par exemple les séparations de mots et les tirets.
BreakOpportunity.ANYTout caractère de l’objet ContentElement est traité comme une possibilité de saut de ligne. Cette valeur est généralement utilisée lorsque du texte Romain est intégré dans du texte asiatique et qu’il est préférable que les sauts de ligne interviennent au milieu des mots.
BreakOpportunity.NONEAucun caractère de la plage n’est traité comme une possibilité de saut de ligne.
BreakOpportunity.ALLTous les caractères de la plage sont traités comme des possibilités de saut de ligne, ce qui signifie qu’un saut de ligne se produit après chaque caractère. Cela est utile pour la création d’effets tels qu’un texte sur un tracé.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementDétermine la possibilité de séparation entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null, le format du premier des éléments adjacents est utilisé.
TextElementDétermine la possibilité de séparation entre les caractères de l’élément de texte.



Implémentation
    public function get breakOpportunity():String
    public function set breakOpportunity(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à BreakOpportunity.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

color

propriété 
color:uint

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

Indique la couleur du texte. Nombre entier contenant trois composants RVB 8 bits ; par exemple, 0xFF0000 correspond au rouge et 0x00FF00 au vert.

La valeur par défaut est 0x000000 (noir).

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDéfinit la couleur du texte.



Implémentation
    public function get color():uint
    public function set color(value:uint):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

digitCase

propriété 
digitCase:String

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

Casse numérique utilisée pour ce texte. La casse des chiffres affecte le style et le positionnement des groupes de caractères numériques. Utilisez les constantes DigitCase pour cette propriété.

La valeur par défaut est DigitCase.DEFAULT.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
DigitCase.DEFAULTApplique une casse de chiffres par défaut au texte.
DigitCase.LININGApplique la casse de chiffres des lignes au texte.
DigitCase.OLD_STYLEApplique l’ancienne casse de chiffres de style au texte.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine le casse des chiffres utilisée pour le texte dans l’élément.



Implémentation
    public function get digitCase():String
    public function set digitCase(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à DigitCase.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Eléments de l’API associés

digitWidth

propriété 
digitWidth:String

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

Largeur de chiffres utilisée pour ce texte. Utilisez les constantes DigitWidth pour cette propriété.

La valeur par défaut est DigitWidth.DEFAULT.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
DigitWidth.DEFAULTApplique une largeur de chiffres par défaut au texte.
DigitWidth.PROPORTIONALApplique une largeur de chiffres proportionnelle au texte.
DigitWidth.TABULARApplique une largeur de chiffres tabulaire au texte.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine l’épaisseur des chiffres utilisée pour le texte dans l’élément.



Implémentation
    public function get digitWidth():String
    public function set digitWidth(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à DigitWidth.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Eléments de l’API associés

dominantBaseline

propriété 
dominantBaseline:String

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

Spécifie le type de ligne de base à utiliser comme ligne de base dominante. La ligne de base dominante est alignée sur la ligne de base d’alignement pour déterminer la position verticale de l’élément sur la ligne. Utilisez les constantesTextBaseline pour cette propriété.

Le contenu de l’élément détermine les lignes de base. Dans le cas d’un TextElement, la police et la taille de la police déterminent les lignes de base. Dans le cas d’un ForeignElement, la hauteur de l’élément détermine les lignes de base.

La valeur par défaut est TextBaseline.ROMAN.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
TextBaseline.ROMANLa ligne de base des caractères romains de l’élément s’aligne avec alignmentBaseline.
TextBaseline.ASCENTLa ligne de base des caractères ascendants de l’élément s’aligne avec alignmentBaseline.
TextBaseline.DESCENTLa ligne de base des caractères descendants de l’élément s’aligne avec alignmentBaseline.
TextBaseline.IDEOGRAPHIC_TOPLa ligne de base du haut des caractères idéographiques de l’élément s’aligne avec alignmentBaseline.
TextBaseline.IDEOGRAPHIC_CENTERLa ligne de base du centre des caractères idéographiques de l’élément s’aligne avec alignmentBaseline.
TextBaseline.IDEOGRAPHIC_BOTTOMLa ligne de base du bas des caractères idéographiques de l’élément s’aligne avec alignmentBaseline.

Sous-classeEffet de la définition des propriétés
GraphicElementDétermine quelles lignes de base de l’élément graphique s’alignent sur le alignmentBaseline.
GroupElementN’a aucun effet.
TextElementDétermine quelles lignes de base de l’élément de texte s’alignent sur le alignmentBaseline.



Implémentation
    public function get dominantBaseline():String
    public function set dominantBaseline(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextBaseline.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

fontDescription

propriété 
fontDescription:FontDescription

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

Objet dont les propriétés décrivent une police.

La valeur par défaut est un objet FontDescription créé par défaut.

Lorsque la propriété fontDescription est définie, l’objet FontDescription fourni est bloqué : sa propriété locked est définie sur true. Il est impossible de modifier un objet FontDescription bloqué.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine la police utilisée pour le texte dans l’élément.



Implémentation
    public function get fontDescription():FontDescription
    public function set fontDescription(value:FontDescription):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Eléments de l’API associés

fontSize

propriété 
fontSize:Number

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

La taille du texte, en pixels.

La valeur par défaut est 12.0.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine la taille pour le texte de l’élément, en pixels.



Implémentation
    public function get fontSize():Number
    public function set fontSize(value:Number):void

Valeur émise
ArgumentError — Si défini sur une valeur inférieure à zéro.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

kerning

propriété 
kerning:String

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

Le crénage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité. Le crénage est pris en charge pour toutes les polices qui disposent de tables de crénage.

La valeur par défaut est Kerning.ON.

Pour définir les valeurs pour cette propriété, utilisez les constantes suivantes dans la classe Kerning :

Valeur de chaîneDescription
Kerning.ONLe crénage est activé.
Kerning.OFFLe crénage est désactivé.
Kerning.AUTOLe crènage est activé, sauf lorsque cela n’est pas nécessaire dans la typographie asiatique. Le crénage est appliqué entre deux caractères lorsque aucun d’eux n’est un caractère Kanji, Hiragana ou Katakana.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementDétermine si le crénage est appliqué entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null, le format du premier des éléments adjacents est utilisé.
TextElementDétermine si le crénage est appliqué entre les caractères dans l’élément de texte.



Implémentation
    public function get kerning():String
    public function set kerning(value:String):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

ligatureLevel

propriété 
ligatureLevel:String

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

Niveau de ligature utilisé pour ce texte. Une ligature se produit lorsque plusieurs formes de lettres sont unies dans un seul glyphe. Les ligatures remplacent généralement des caractères consécutifs partageant des composants communs, par exemple les paires de lettres ’fi’, ’fl’ ou ’ae’. Elles sont utilisées avec les jeux de caractères latins et non latins. Utilisez les constantes LigatureLevel pour cette propriété.

La valeur par défaut est LigatureLevel.COMMON.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
LigatureLevel.NONEAucune ligature n’est créée.
LigatureLevel.MINIMUMDes ligatures minimales sont créées.
LigatureLevel.COMMONDes ligatures courantes sont créées.
LigatureLevel.UNCOMMONDes ligatures rares sont créées.
LigatureLevel.EXOTICDes ligatures exotiques sont créées.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementDétermine le niveau de ligature entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null, le format du premier des éléments adjacents est utilisé.
TextElementDétermine le niveau de ligature entre les caractères de l’élément de texte.



Implémentation
    public function get ligatureLevel():String
    public function set ligatureLevel(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à LigatureLevel.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Eléments de l’API associés

locale

propriété 
locale:String

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

Variable locale du texte. Contrôle les transformations de casse et de forme. Les identifiants locaux standards sont utilisés. Par exemple « en », « en_US » et « en-US » pour l’anglais, « ja » pour le japonais. Voir la liste des codes ISO 639-2 pour obtenir la liste des codes de paramètres régionaux.

La valeur par défaut est "en".

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine les transformations et les formes du texte dans l’élément.



Implémentation
    public function get locale():String
    public function set locale(value:String):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

locked

propriété 
locked:Boolean

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

Indique si l’objet ElementFormat est bloqué. Si la propriété est définie sur true, l’objet ElementFormat ne peut pas être modifié. Appelez ElementFormat.clone() pour obtenir une copie non verrouillée de l’objet ElementFormat.



Implémentation
    public function get locked():Boolean
    public function set locked(value:Boolean):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

textRotation

propriété 
textRotation:String

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

Définit la rotation appliquée aux glyphes individuelles. Utilisez les constantes définies dans la classe TextRotation pour cette propriété.

La valeur par défaut est TextRotation.AUTO.

La rotation finale des glyphes est la somme de , ElementFormat.textRotation, ContentElement.textRotation et TextBlock.lineRotation.

Vous devez normalement utiliser cette propriété pour le texte asiatique, dont les caractères doivent pivoter pour s’afficher verticalement. Pour ce faire, utilisez TextRotation.AUTO avec TextBlock.lineRotation = TextRotation.ROTATE_90.

La définition de cette propriété sur des polices qui ne contiennent pas d’informations de disposition verticale risque de donner des résultats inattendus. Les polices qui contiennent une table vmtx ou VORG, telles que la police japonaise « MS Mincho », fonctionnent correctement. En effet, ces tables fournissent les données dont le moteur de disposition a besoin pour effectuer une mise en forme appropriée. Les polices comme Verdana, qui ne contiennent pas les informations nécessaires, ne fonctionnent pas correctement.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
TextRotation.ROTATE_0Les glyphes ne pivotent pas.
TextRotation.ROTATE_90Les glyphes pivotent de 90 degrés vers la droite.
TextRotation.ROTATE_180Les glyphes pivotent de 180 degrés.
TextRotation.ROTATE_270Les glyphes pivotent de 270 degrés vers la droite.
TextRotation.AUTOSpécifie une rotation de 90 degrés vers la gauche pour les glyphes larges et de pleine épaisseur uniquement, tels que déterminés par les propriétés Unicode du glyphe. Cette valeur est généralement utilisée avec du texte asiatique pour ne faire pivoter que les glyphes requérant une rotation. Cette rotation est uniquement appliquée au texte vertical pour orienter verticalement les caractères larges et de pleine épaisseur sans affecter les autres caractères.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine la rotation des glyphes dans l’élément de texte.



Implémentation
    public function get textRotation():String
    public function set textRotation(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextRotation.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

trackingLeft

propriété 
trackingLeft:Number

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

Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels. Si kerning est activé, la valeur trackingLeft est ajoutée aux valeurs dans la table de crénage de la police. Si kerning est désactivé, la valeur trackingLeft est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.

De façon générale, la valeur de suivi désirée est divisée entre trackingRight et trackingLeft. Autrement, dans le cas de texte combinant plusieurs directions, le suivi est double au niveau d’une limite bidirectionnelle et nul pour l’autre.

La valeur par défaut est 0.0.

Sous-classeEffet de la définition des propriétés
GraphicElementDétermine le suivi appliqué à gauche du graphique.
GroupElementN’a aucun effet.
TextElementDétermine le suivi appliqué à gauche des caractères dans l’élément de texte.

Exemple :

          //positive tracking added to kerning
          var ef1:ElementFormat = new ElementFormat();
          ef1.kerning = flash.text.engine.Kerning.ON;
          ef1.trackingLeft = 0.5;
     
          //negative manual kerning
          var ef2:ElementFormat = new ElementFormat();
          ef2.kerning = flash.text.engine.Kerning.OFF;
          ef2.trackingLeft = -1.0;
     



Implémentation
    public function get trackingLeft():Number
    public function set trackingLeft(value:Number):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

trackingRight

propriété 
trackingRight:Number

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

Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels. Si kerning est activé, la valeur trackingRight est ajoutée aux valeurs dans la table de crénage de la police. Si kerning est désactivé, la valeur trackingRight est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.

De façon générale, la valeur de suivi désirée est divisée entre trackingRight et trackingLeft. Autrement, dans le cas de texte combinant plusieurs directions, le suivi est double au niveau d’une limite bidirectionnelle et nul pour l’autre.

La valeur par défaut est 0.0.

Sous-classeEffet de la définition des propriétés
GraphicElementDétermine le suivi appliqué à droite du graphique.
GroupElementN’a aucun effet.
TextElementDétermine le suivi appliqué à droite des caractères dans l’élément de texte.

Exemple :

          //positive tracking added to kerning
          var ef1:ElementFormat = new ElementFormat();
          ef1.kerning = flash.text.engine.Kerning.ON;
          ef1.trackingRight = 0.5;
     
          //negative manual kerning
          var ef2:ElementFormat = new ElementFormat();
          ef2.kerning = flash.text.engine.Kerning.OFF;
          ef2.trackingRight = -1.0;
     



Implémentation
    public function get trackingRight():Number
    public function set trackingRight(value:Number):void

Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

typographicCase

propriété 
typographicCase:String

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

Casse typographique utilisée pour ce texte. Utilisez les constantes définies dans la classe TypographicCase pour cette propriété.

La valeur par défaut est TypographicCase.DEFAULT.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Valeur de chaîneDescription
TypographicCase.DEFAULTIndique que le style de casse normal est utilisé pour tous les caractères.
TypographicCase.TITLESpécifie que les caractères majuscules utilisent des glyphes de titre en sortie.
TypographicCase.CAPSSpécifie que l’espacement est ajusté pour les caractères majuscules en sortie.
TypographicCase.SMALL_CAPSSpécifie que les caractères majuscules utilisent des glyphes de petites majuscules en sortie.
TypographicCase.UPPERCASESpécifie que tous les caractères utilisent des glyphes majuscules en sortie.
TypographicCase.LOWERCASESpécifie que tous les caractères utilisent des glyphes minuscules en sortie.
TypographicCase.CAPS_AND_SMALL_CAPSSpécifie que les caractères minuscules utilisent des glyphes de petites majuscules en sortie.

Sous-classeEffet de la définition des propriétés
GraphicElementN’a aucun effet.
GroupElementN’a aucun effet.
TextElementDétermine la casse typographique utilisée pour le texte dans l’élément.



Implémentation
    public function get typographicCase():String
    public function set typographicCase(value:String):void

Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TypographicCase.
 
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true).

Plus d’exemples

Eléments de l’API associés

Détails du constructeur

ElementFormat

()Constructeur
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")

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

Crée un objet ElementFormat.

Paramètres
fontDescription:FontDescription (default = null) — Objet FontDescription identifiant la police utilisée avec cette mise en forme d’élément. La valeur par défaut est null. Lorsque aucune description de police n’est fournie, une description de police par défaut est construite.
 
fontSize:Number (default = 12.0) — La taille du texte, en pixels.
 
color:uint (default = 0x000000) — Couleur du texte. Nombre hexadécimal contenant trois composants RVB 8 bits ; par exemple, 0xFF0000 correspond au rouge et 0x00FF00 au vert.
 
alpha:Number (default = 1.0) — Propriété alpha appliquée à tous les atomes de ligne sur la base de la mise en forme des éléments.
 
textRotation:String (default = "auto") — rotation appliquée aux glyphes individuelles. Utilisez les constantes TextRotation pour cette propriété.
 
dominantBaseline:String (default = "roman") — Ligne de base à laquelle les glyphes du texte s’accrochent. Utilisez les constantes TextBaseline pour cette propriété.
 
alignmentBaseline:String (default = "useDominantBaseline") — Ligne de base sur la ligne conteneur à laquelle la ligne de base dominante s’accroche. Utilisez les constantes TextBaseline pour cette propriété.
 
baselineShift:Number (default = 0.0) — Décalage de la ligne de base pour le texte, en pixels em.
 
kerning:String (default = "on") — Crénage utilisé pour ce texte. Utilisez les constantes définies dans la classe Kerning.
 
trackingRight:Number (default = 0.0) — Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels.
 
trackingLeft:Number (default = 0.0) — Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels.
 
locale:String (default = "en") — Variable locale du texte.
 
breakOpportunity:String (default = "auto") — Opportunité de saut de ligne appliquée à ce texte. Utilisez les constantes BreakOpportunity pour cette propriété.
 
digitCase:String (default = "default") — Casse numérique utilisée pour ce texte. Utilisez les constantes DigitCase pour cette propriété.
 
digitWidth:String (default = "default") — Largeur de chiffres utilisée pour ce texte. Utilisez les constantes DigitWidth pour cette propriété.
 
ligatureLevel:String (default = "common") — Niveau de ligature utilisé pour ce texte. Utilisez les constantes LigatureLevel pour cette propriété.
 
typographicCase:String (default = "default") — Casse typographique utilisée pour ce texte. Utilisez les constantes TypographicCase pour cette propriété.

Valeur émise
ArgumentError — Le paramètre fontSize spécifié est inférieur à 0.
 
ArgumentError — Le paramètre textRotation spécifié n’appartient pas à TextRotation.
 
ArgumentError — Le paramètre dominantBaseline spécifié n’appartient pas àTextBaseline.
 
ArgumentError — Le paramètre alignmentBaseline spécifié n’appartient pas àTextBaseline.
 
ArgumentError — Le paramètre kerning spécifié n’appartient pas à Kerning.
 
ArgumentError — Le paramètre breakOpportunity spécifié n’appartient pas à BreakOpportunity.
 
ArgumentError — Le paramètre digitCase spécifié n’appartient pas à DigitCase.
 
ArgumentError — Le paramètre digitWidth spécifié n’appartient pas à DigitWidth.
 
ArgumentError — Le paramètre ligatureLevel spécifié n’appartient pas à LigatureLevel.
 
ArgumentError — Le paramètre typographicCase spécifié n’appartient pas à TypographicCase.
Détails de la méthode

clone

()méthode
public function clone():ElementFormat

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

Crée une copie non verrouillée et clonée de l’objet ElementFormat.

Valeur renvoyée
ElementFormat — Une copie non verrouillée de l’objet ElementFormat.

Plus d’exemples


Exemple  ( Comment utiliser cet exemple )

Cet exemple crée un objet ElementFormat et définit la propriété FontSize. Un nouvel objet TextElement est créé (et bloqué), à l’aide d’ElementFormat et TextElement est utilisé comme contenu pour un TextBlock. Une ligne de texte est créée à partir du TextBlock.

Pour modifier l’objet ElementFormat, vous devez tout d’abord vérifier sa propriété locked. Si elle est définie sur true, utilisez la méthode clone() pour créer une copie non verrouillée de l’objet ElementFormat, modifiez ses propriétés, puis associez à nouveau le nouvel objet ElementFormat au TextBlock. Lorsque les lignes sont de nouveau scindées, les nouvelles récupèrent les nouveaux paramètres de police.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormat_cloneExample extends Sprite {
        private var ef1:ElementFormat;
        private var ef2:ElementFormat;
        
        public function ElementFormat_cloneExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize=20;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            
            ef2 = (ef1.locked) ? ef1.clone() : ef1;    
            ef2.fontSize = 32;

            tb.content.elementFormat=ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            
        }
    }    
}

getFontMetrics

()méthode 
public function getFontMetrics():FontMetrics

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

Renvoie un objet FontMetrics avec des propriétés qui décrivent la valeur emBox, la position et l’épaisseur du barré et du soulignement pour la police spécifiée par fontDescription et fontSize.

Valeur renvoyée
FontMetrics — Objet FontMetrics décrivant les propriétés de la police spécifiée par fontDescription.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Cet exemple crée un objet ElementFormat avec un FontDescription affecté et utilise la méthode getFontMetrics pour afficher les mesures de la police choisie (24 points).
package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontMetricsExample extends Sprite {
        
        public function FontMetricsExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 24;            
            var fm1:FontMetrics = ef1.getFontMetrics();

            trace(fm1.emBox);
            trace(fm1.strikethroughOffset);
            trace(fm1.strikethroughThickness);
            trace(fm1.subscriptScale);
            trace(fm1.subscriptOffset);
            trace(fm1.superscriptScale);
            trace(fm1.superscriptOffset);
            trace(fm1.underlineOffset);
            trace(fm1.underlineThickness);
            
            
        }
    }    
}
ElementFormatExample.as

Cet exemple crée deux objets ElementFormat et définit plusieurs de leurs propriétés. Il affecte ensuite le nouvel ElementFormats à un objet TextElement, qui a été affecté en tant que contenu d’un TextBlock. Notez que la modification du ElementFormat d’un TextElement n’affecte pas les TextLines créés précédemment par le TextBlock parent.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormatExample extends Sprite {
        
        public function ElementFormatExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            ef1.alpha = 100;
            ef1.kerning = flash.text.engine.Kerning.ON;
            ef1.trackingRight = 2;
            ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
            ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
            ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
            
            var ef2:ElementFormat = new ElementFormat(fd);
            ef2.fontSize = 30;
            ef2.color = 0xFF0000;
            ef2.alpha = 0.3;
            ef2.kerning = flash.text.engine.Kerning.OFF;
            ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
            ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
            ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            line1.x = 15;
            line1.y = 30;

            tb.content.elementFormat = ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            line2.x = 15;
            line2.y = 60;
            
        }
    }    
}




[ 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.