| Package | mx.controls.advancedDataGridClasses |
| Classe | public class AdvancedDataGridColumn |
| Héritage | AdvancedDataGridColumn  CSSStyleDeclaration EventDispatcher Object |
| Implémente | IIMESupport |
| Sous-classes | AdvancedDataGridColumnGroup |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Remarques :
- Une classe AdvancedDataGridColumn comporte uniquement les informations relatives à une colonne ; il ne s’agit pas du parent des rendus d’élément dans la colonne.
- Si vous spécifiez une classe AdvancedDataGridColumn sans propriété
dataField, vous devez spécifier une propriétésortCompareFunction. Sinon, les opérations de tri risquent de provoquer des erreurs d’exécution.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLYou use the <mx.AdvancedDataGridcolumn> tag to configure a column
of a AdvancedDataGrid control.
You specify the <mx.AdvancedDataGridcolumn> tag as a child
of the columns property in MXML.
The <mx.AdvancedDataGridcolumn> tag inherits all of the
tag attributes of its superclass, and adds the following tag attributes:
<mx:AdvancedDataGridColumn
Properties
dataField="No default"
dataTipField="No default"
dataTipFunction="No default"
editable="true|false"
editorDataField="text"
editorHeightOffset="0"
editorUsesEnterKey="false|true"
editorWidthOffset="0"
editorXOffset="0"
editorYOffset="0"
formatter="null"
headerRenderer="AdvancedDataGridHeaderRenderer"
headerText="No default"
headerWordWrap="undefined"
imeMode="null"
itemEditor="TextInput"
itemRenderer="AdvancedDataGridItemRenderer"
labelFunction="No default"
minWidth="20"
rendererIsEditor="false|true"
resizable="true|false"
showDataTips="false|true"
sortable="true|false"
sortCompareFunction="No default"
sortDescending="false|true"
styleFunction="No default"
visible="true|false"
width="100"
wordWrap="false|true"
Styles
backgroundColor="0xFFFFFF"
color="No default."
disabledColor="0xAAB3B3"
fontAntiAliasType="advanced"
fontFamily="No default"
fontGridFitType="pixel"
fontSharpness="0"
fontSize="No default"
fontStyle="normal|italic"
fontThickness="0"
fontWeight="normal|bold"
headerStyleName="No default"
kerning="false|true"
letterSpacing="0"
paddingLeft="0"
paddingRight="0"
textAlign="right|center|left"
textDecoration="none|underline"
textIndent="0"
/>
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| dataField : String
Nom du champ ou de la propriété de l’élément de fournisseur de données associé à la colonne. | AdvancedDataGridColumn | ||
| dataTipField : String
Nom du champ dans le fournisseur de données à afficher comme astuce sur les données. | AdvancedDataGridColumn | ||
| dataTipFunction : Function
Indique une fonction de rappel à exécuter sur chaque élément du fournisseur de données afin d’en déterminer les astuces sur les données. | AdvancedDataGridColumn | ||
| defaultFactory : Function
Cette fonction, si elle n’est pas null, est généralement générée automatiquement par le compilateur MXML. | CSSStyleDeclaration | |
| draggable : Boolean = true
Indicateur précisant si l’utilisateur est autorisé à faire glisser la colonne vers une nouvelle position. Si la valeur est true, l’utilisateur peut faire glisser les en-têtes de colonne vers une nouvelle position
| AdvancedDataGridColumn | ||
| editable : Boolean = true
Indicateur précisant si les éléments de la colonne peuvent être modifiés. | AdvancedDataGridColumn | ||
| editorDataField : String = "text"
Nom de la propriété de l’éditeur d’élément contenant les nouvelles données de l’élément de la liste. | AdvancedDataGridColumn | ||
| editorHeightOffset : Number = 0
Hauteur de l’éditeur d’élément, en pixels, par rapport à la taille du rendu d’élément. | AdvancedDataGridColumn | ||
| editorUsesEnterKey : Boolean = false
Indicateur précisant si l’éditeur d’élément utilise la touche Entrée. | AdvancedDataGridColumn | ||
| editorWidthOffset : Number = 0
Largeur de l’éditeur d’élément, en pixels, par rapport à la taille du rendu d’élément. | AdvancedDataGridColumn | ||
| editorXOffset : Number = 0
Emplacement x du coin supérieur gauche de l’éditeur d’élément, en pixels, par rapport au coin supérieur gauche de l’élément. | AdvancedDataGridColumn | ||
| editorYOffset : Number = 0
Emplacement y du coin supérieur gauche de l’éditeur d’élément, en pixels, par rapport au coin supérieur gauche de l’élément. | AdvancedDataGridColumn | ||
| enableIME : Boolean [lecture seule]
Indicateur qui signale si l’IME doit être activé lorsque le composant reçoit le focus. | AdvancedDataGridColumn | ||
| factory : Function
Cette fonction, si elle n’est pas null, est généralement générée automatiquement par le compilateur MXML. | CSSStyleDeclaration | |
| formatter : IFormatter
Instance d’une sous-classe de mx.formatters.Formatter. | AdvancedDataGridColumn | ||
| headerRenderer : IFactory
Fabrique de classe des instances de rendu d’élément qui affichent l’en-tête de la colonne. | AdvancedDataGridColumn | ||
| headerText : String
Texte de l’en-tête de cette colonne. | AdvancedDataGridColumn | ||
| headerWordWrap : *
La valeur est true pour enrouler le texte dans l’en-tête de colonne s’il ne tient pas sur une seule ligne. | AdvancedDataGridColumn | ||
| imeMode : String
Spécifie le mode IME (éditeur de méthode d’entrée). | AdvancedDataGridColumn | ||
| itemEditor : IFactory
Fabrique de classe des instances de l’éditeur d’élément à utiliser pour la colonne lorsqu’elle est modifiable. | AdvancedDataGridColumn | ||
| itemRenderer : IFactory
Fabrique de classe des instances de rendu d’élément qui affichent les données de chaque élément de la colonne. | AdvancedDataGridColumn | ||
| labelFunction : Function
Fonction qui détermine le texte à afficher dans cette colonne. | AdvancedDataGridColumn | ||
| minWidth : Number
Largeur minimale de la colonne, en pixels. | AdvancedDataGridColumn | ||
| overrides : Object
Si la méthode setStyle() est appelée sur un composant UIComponent ou CSSStyleDeclaration lors de l’exécution, cet objet stocke les paires nom/valeur qui ont été définies ; elles remplacent les paires nom/valeur des objets produits par les méthodes spécifiées par les propriétés defaultFactory et factory. | CSSStyleDeclaration | |
| rendererIsEditor : Boolean = false
Indicateur précisant que le rendu d’élément est également un éditeur d’élément. | AdvancedDataGridColumn | ||
| resizable : Boolean = true
La valeur est true si l’utilisateur est autorisé à redimensionner la largeur de la colonne. | AdvancedDataGridColumn | ||
| selector : CSSSelector
Cette propriété correspond au sélecteur de base d’une chaîne potentielle de sélecteurs et de conditions utilisés pour faire correspondre une déclaration de style CSS à des composants. | CSSStyleDeclaration | |
| selectorIndex : int = 0
L’ordre dans lequel cet objet CSSStyleDeclaration a été ajouté à son gestionnaire StyleManager. | CSSStyleDeclaration | |
| showDataTips : *
La valeur est définie sur true pour afficher les astuces sur les données dans la colonne. | AdvancedDataGridColumn | ||
| sortable : Boolean = true
La valeur est définie sur true pour indiquer que l’utilisateur peut cliquer sur l’en-tête de cette colonne pour trier le fournisseur de données. | AdvancedDataGridColumn | ||
| sortCompareFunction : Function
Fonction de rappel appelée lors du tri des données dans la colonne. | AdvancedDataGridColumn | ||
| sortDescending : Boolean = false
Indique si le tri de colonne s’effectue par ordre croissant (false) ou décroissant (true). | AdvancedDataGridColumn | ||
| specificity : int [lecture seule]
Détermine l’ordre de priorité lors de l’application de plusieurs déclarations de style à un composant. | CSSStyleDeclaration | |
| styleFunction : Function
Fonction de rappel qui est appelée lors du rendu de chaque cellule. | AdvancedDataGridColumn | ||
| subject : String [lecture seule]
Le sujet décrit le nom d’un composant pouvant être une correspondance potentielle pour cette déclaration de style. | CSSStyleDeclaration | |
| visible : Boolean
Si la valeur est true, la colonne est visible. | AdvancedDataGridColumn | ||
| width : Number
Largeur de la colonne, en pixels. | AdvancedDataGridColumn | ||
| wordWrap : *
Lorsque la valeur est définie sur false, le texte est enroulé dans une rangée de cette colonne, car il ne tient pas sur une seule ligne. Si la valeur est undefined, la propriété wordWrap du contrôle AdvancedDataGrid est utilisée. | AdvancedDataGridColumn | ||
| Méthode | Défini par | ||
|---|---|---|---|
AdvancedDataGridColumn(columnName:String = null)
Constructeur. | AdvancedDataGridColumn | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Supprime une propriété de style pour cet objet CSSStyleDeclaration. | CSSStyleDeclaration | |
Clonez cette colonne et renvoyez une nouvelle colonne avec les mêmes propriétés et styles que celle-ci. | AdvancedDataGridColumn | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Récupère la valeur d’une propriété de style spécifiée, telle que déterminée uniquement par cet objet CSSStyleDeclaration. | CSSStyleDeclaration | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
Renvoie une chaîne que le rendu d’élément affiche sous forme d’astuce sur les données pour l’objet de données fourni, en fonction des propriétés dataTipField et dataTipFunction. | AdvancedDataGridColumn | ||
Renvoie la chaîne que le rendu d’élément affiche pour l’objet de données spécifié. | AdvancedDataGridColumn | ||
|
Détermine si cette déclaration de style s’applique au composant donné en fonction d’une correspondance de la chaîne de sélecteur. | CSSStyleDeclaration | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Définit une propriété de style pour cet objet CSSStyleDeclaration. | CSSStyleDeclaration | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
| Style | Description | Défini par | ||
|---|---|---|---|---|
backgroundColor | Type: uint Format: Color Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur d’arrière-plan de la colonne. La valeur par défaut est undefined, ce qui signifie que la valeur du style backgroundColor du contrôle AdvancedDataGrid associé est utilisée. La valeur par défaut du contrôle AdvancedDataGrid est 0xFFFFFF.
| AdvancedDataGridColumn | ||
color | Type: uint Format: Color Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur du texte du composant, libellé du composant inclus. La valeur par défaut est 0x0B333C. | AdvancedDataGridColumn | ||
disabledColor | Type: uint Format: Color Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur de texte dans le composant s’il est désactivé. La valeur par défaut est 0xAAB3B3. | AdvancedDataGridColumn | ||
fontAntiAliasType | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Définit la propriété antiAliasType des objets TextField internes. Les valeurs possibles sont "normal" (flash.text.AntiAliasType.NORMAL) et "advanced" (flash.text.AntiAliasType.ADVANCED).
La valeur par défaut est Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est "advanced".Eléments de l’API associés | AdvancedDataGridColumn | ||
fontFamily | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nom de la police à utiliser. A la différence d’une implémentation CSS complète, les listes de valeurs séparées par des virgules ne sont pas prises en charge. Vous pouvez utiliser n’importe quel nom de famille de polices. Si vous spécifiez un nom de police générique, il est converti dans la police de périphérique appropriée. La valeur par défaut est "Verdana". | AdvancedDataGridColumn | ||
fontGridFitType | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Définit la propriété gridFitType des objets TextField internes représentant le texte dans les contrôles Flex. Les valeurs possibles sont "none" (flash.text.GridFitType.NONE), "pixel" (flash.text.GridFitType.PIXEL) et "subpixel" (flash.text.GridFitType.SUBPIXEL).
Cette propriété est prise en compte uniquement si vous utilisez une police anticrénelage avancée incorporée et que la propriété Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est "pixel".Eléments de l’API associés | AdvancedDataGridColumn | ||
fontSharpness | Type: Number Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Définit la propriété sharpness des objets TextField internes représentant le texte dans les contrôles Flex. Cette propriété spécifie la netteté du contour des glyphes. Les nombres possibles vont de -400 à 400.
Cette propriété est prise en compte uniquement si vous utilisez une police anticrénelage avancée incorporée et que la propriété Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est 0.Eléments de l’API associés | AdvancedDataGridColumn | ||
fontSize | Type: Number Format: Length Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Hauteur du texte, en pixels. La valeur par défaut est 10 pour tous les contrôles, à l’exception de ColorPicker. Pour le contrôle ColorPicker, la valeur par défaut est 11. | AdvancedDataGridColumn | ||
fontStyle | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Détermine si le texte doit être en italique. Les valeurs reconnues sont "normal" et "italic".
La valeur par défaut est "normal". | AdvancedDataGridColumn | ||
fontThickness | Type: Number Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Définit la propriété thickness des sous-contrôles TextField internes qui représentent le texte des contrôles Flex. Cette propriété spécifie l’épaisseur du contour des glyphes. Les nombres possibles vont de -200 à 200.
Cette propriété est prise en compte uniquement si vous utilisez une police anticrénelage avancée incorporée et que la propriété Ce style n’a aucun effet sur les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est 0.Eléments de l’API associés | AdvancedDataGridColumn | ||
fontWeight | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Détermine si le texte doit être en gras. Les valeurs reconnues sont "normal" et "bold". Pour les contrôles Button, la valeur par défaut est "bold".
La valeur par défaut est "normal". | AdvancedDataGridColumn | ||
headerStyleName | Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nom d’une déclaration de style CSS permettant de contrôler d’autres aspects de l’apparence des en-têtes de colonne. La valeur par défaut est undefined, ce qui signifie que la valeur du style headerStyleName du contrôle AdvancedDataGrid associé est utilisée. La valeur par défaut du contrôle AdvancedDataGrid est ".advancedDataGridStyles".
| AdvancedDataGridColumn | ||
kerning | Type: Boolean Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Valeur booléenne indiquant si le crénage est activé ( true) ou désactivé (false). Le crénage ajuste le pas entre certaines paires de caractères pour améliorer la lisibilité et ne doit être employé que si nécessaire, dans les titres en grande police, par exemple. Le crénage est pris en charge uniquement pour les polices anticrénelage avancées incorporées. Certaines polices, telles que Verdana, et les polices à espacement fixe, telles que Courier New, ne prennent pas en charge le crénage.
La valeur par défaut est false. | AdvancedDataGridColumn | ||
letterSpacing | Type: Number Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nombre de pixels supplémentaires devant apparaître entre chaque caractère. Une valeur positive augmente l’espacement des caractères par rapport à l’espacement normal, alors qu’une valeur négative le réduit. La valeur par défaut est 0. | AdvancedDataGridColumn | ||
paddingLeft | Type: Number Format: Length Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nombre de pixels entre la bordure gauche du conteneur et sa zone de contenu. Il n’existe pas de valeur par défaut pour ce style. Le paramètre d’un rendu d’élément de la propriété paddingRight permet de déterminer la valeur par défaut.
| AdvancedDataGridColumn | ||
paddingRight | Type: Number Format: Length Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nombre de pixels entre la bordure droite du conteneur et sa zone de contenu. Il n’existe pas de valeur par défaut pour ce style. Le paramètre d’un rendu d’élément de la propriété paddingRight permet de déterminer la valeur par défaut.
| AdvancedDataGridColumn | ||
textAlign | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Alignement du texte au sein d’un conteneur. Les valeurs possibles sont "left", "right" ou "center".
La valeur par défaut pour la plupart des contrôles est | AdvancedDataGridColumn | ||
textDecoration | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Détermine si le texte est souligné. Les valeurs possibles sont "none" et "underline".
La valeur par défaut est "none". | AdvancedDataGridColumn | ||
textIndent | Type: Number Format: Length Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Décalage de la première ligne de texte par rapport au côté gauche du conteneur (en pixels). La valeur par défaut est 0. | AdvancedDataGridColumn | ||
dataField | propriété |
dataField:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom du champ ou de la propriété de l’élément de fournisseur de données associé à la colonne. Chaque contrôle AdvancedDataGridColumn nécessite cette propriété et/ou la propriété labelFunction pour être définie, afin de calculer le texte affichable pour le rendu d’élément. Si les propriétés dataField et labelFunction sont définies, les données s’affichent à l’aide de la propriété labelFunction et sont triées à l’aide de la propriété dataField. Si la propriété nommée dans la propriété dataField n’existe pas, la propriété sortCompareFunction doit être définie afin que le tri fonctionne correctement.
La valeur de cette propriété n’est pas nécessairement la chaîne qui est affichée dans l’en-tête de colonne. Cette propriété est utilisée uniquement pour accéder aux données dans le fournisseur de données. Pour plus d’informations, voir la propriété headerText.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataFieldChanged .
Implémentation
public function get dataField():String public function set dataField(value:String):voidEléments de l’API associés
dataTipField | propriété |
dataTipField:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom du champ dans le fournisseur de données à afficher comme astuce sur les données. Par défaut, le contrôle AdvancedDataGrid recherche la propriété label sur chaque élément du fournisseur de données et l’affiche. Toutefois, si le fournisseur de données ne contient pas de propriété label, vous pouvez définir la propriété dataTipField pour qu’elle spécifie une autre propriété. Par exemple, vous pouvez définir la valeur sur « FullName » lorsqu’un utilisateur affiche un ensemble de noms de personnes incluses dans une base de données.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataTipFieldChanged .
Implémentation
public function get dataTipField():String public function set dataTipField(value:String):voiddataTipFunction | propriété |
dataTipFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique une fonction de rappel à exécuter sur chaque élément du fournisseur de données afin d’en déterminer les astuces sur les données. Cette propriété est utilisée par la méthode itemToDataTip().
Par défaut, le contrôle recherche une propriété nommée label sur chaque élément du fournisseur de données et l’affiche comme astuce sur les données. Toutefois, certains fournisseurs de données n’ont pas de propriété label ou une autre propriété qui vous permet d’afficher les données dans les rangées. Un fournisseur de données contenant les champs lastName et firstName, mais dont vous souhaitez afficher les noms complets en tant qu’astuce sur les données (dataTip) en est un exemple. Vous pouvez spécifier une fonction pour la propriété dataTipFunction qui renvoie une seule chaîne contenant la valeur des deux champs. Vous pouvez également utiliser la propriété dataTipFunction pour gérer la mise en forme et la localisation.
La fonction doit accepter un paramètre Object unique et renvoyer une chaîne. Pour la cellule d’en-tête d’une colonne, le paramètre Object est de type AdvancedDataGridColumn. Pour les cellules de tableau, le paramètre Object contient l’élément fournisseur de données de la cellule.
Voici, ci-dessous, un exemple d’implémentation de la fonction. Pour la cellule d’en-tête, renvoie « Column Name ». Pour les cellules de tableau, renvoie la propriété de nom de l’objet :
private function tipFunc(value:Object):String
{
if (value is AdvancedDataGridColumn)
return "Column Name";
// Use the 'name' property of the data provider element.
return "Name: " + value["name"];
}
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataTipFunctionChanged .
Implémentation
public function get dataTipFunction():Function public function set dataTipFunction(value:Function):voiddraggable | propriété |
public var draggable:Boolean = true| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si l’utilisateur est autorisé à faire glisser la colonne vers une nouvelle position. Si la valeur est true, l’utilisateur peut faire glisser les en-têtes de colonne vers une nouvelle position
La valeur par défaut est true.
editable | propriété |
public var editable:Boolean = true| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si les éléments de la colonne peuvent être modifiés. Si la valeur est true et si la propriété editable du contrôle AdvancedDataGrid a également la valeur true, les éléments d’une colonne sont modifiables et peuvent être modifiés individuellement en cliquant sur leur entrée ou en naviguant jusqu’à eux à l’aide des touches de flèche et de tabulation.
La valeur par défaut est true.
editorDataField | propriété |
public var editorDataField:String = "text"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de la propriété de l’éditeur d’élément contenant les nouvelles données de l’élément de la liste. Par exemple, la valeur par défaut de itemEditor étant TextInput, la valeur par défaut de la propriété editorDataField est "text", qui définit la propriété text du contrôle TextInput.
La valeur par défaut est "text".
editorHeightOffset | propriété |
public var editorHeightOffset:Number = 0| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur de l’éditeur d’élément, en pixels, par rapport à la taille du rendu d’élément. Cette propriété peut être utilisée pour faire en sorte que l’éditeur chevauche le rendu d’élément de quelques pixels, afin de compenser la bordure entourant l’éditeur. Notez que le fait de changer ces valeurs alors que l’éditeur est affiché n’a aucun effet sur l’éditeur en cours, mais cela affectera le prochain rendu d’élément qui ouvrira un éditeur.
La valeur par défaut est 0.
editorUsesEnterKey | propriété |
public var editorUsesEnterKey:Boolean = false| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si l’éditeur d’élément utilise la touche Entrée. Si la valeur est true, l’éditeur d’élément utilise la touche Entrée, le contrôle AdvancedDataGrid ne recherchera pas la touche Entrée et ne répondra pas en déplaçant l’éditeur. Notez que le fait de changer cette valeur alors que l’éditeur est affiché n’a aucun effet sur l’éditeur en cours, mais cela affectera le prochain rendu d’élément qui ouvrira un éditeur.
La valeur par défaut est false.
editorWidthOffset | propriété |
public var editorWidthOffset:Number = 0| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur de l’éditeur d’élément, en pixels, par rapport à la taille du rendu d’élément. Cette propriété peut être utilisée pour faire en sorte que l’éditeur chevauche le rendu d’élément de quelques pixels, afin de compenser la bordure entourant l’éditeur. Notez que le fait de changer ces valeurs alors que l’éditeur est affiché n’a aucun effet sur l’éditeur en cours, mais cela affectera le prochain rendu d’élément qui ouvrira un éditeur.
La valeur par défaut est 0.
editorXOffset | propriété |
public var editorXOffset:Number = 0| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Emplacement x du coin supérieur gauche de l’éditeur d’élément, en pixels, par rapport au coin supérieur gauche de l’élément. Cette propriété peut être utilisée pour faire en sorte que l’éditeur chevauche le rendu d’élément de quelques pixels, afin de compenser la bordure entourant l’éditeur. Notez que le fait de changer ces valeurs alors que l’éditeur est affiché n’a aucun effet sur l’éditeur en cours, mais cela affectera le prochain rendu d’élément qui ouvrira un éditeur.
La valeur par défaut est 0.
editorYOffset | propriété |
public var editorYOffset:Number = 0| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Emplacement y du coin supérieur gauche de l’éditeur d’élément, en pixels, par rapport au coin supérieur gauche de l’élément. Cette propriété peut être utilisée pour faire en sorte que l’éditeur chevauche le rendu d’élément de quelques pixels, afin de compenser la bordure entourant l’éditeur. Notez que le fait de changer ces valeurs alors que l’éditeur est affiché n’a aucun effet sur l’éditeur en cours, mais cela affectera le prochain rendu d’élément qui ouvrira un éditeur.
La valeur par défaut est 0.
enableIME | propriété |
enableIME:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indicateur qui signale si l’IME doit être activé lorsque le composant reçoit le focus. Si un éditeur est relevé, il définit enableIME en conséquence.
Implémentation
public function get enableIME():Booleanformatter | propriété |
formatter:IFormatter| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Instance d’une sous-classe de mx.formatters.Formatter. Le contrôle utilise cette classe pour mettre en forme le texte des colonnes.
La valeur par défaut est null.
Implémentation
public function get formatter():IFormatter public function set formatter(value:IFormatter):voidheaderRenderer | propriété |
headerRenderer:IFactory| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fabrique de classe des instances de rendu d’élément qui affichent l’en-tête de la colonne. Vous pouvez spécifier le composant d’un rendu d’élément supplémentaire, d’un rendu d’élément intégré ou d’un rendu d’élément personnalisé comme valeur pour cette propriété.
Le rendu d’élément par défaut est la classe AdvancedDataGridItemRenderer, qui affiche les données de l’élément sous forme de texte.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement headerRendererChanged .
Implémentation
public function get headerRenderer():IFactory public function set headerRenderer(value:IFactory):voidheaderText | propriété |
headerText:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Texte de l’en-tête de cette colonne. Par défaut, le contrôle AdvancedDataGrid utilise la valeur de la propriété dataField comme texte de l’en-tête.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement headerTextChanged .
Implémentation
public function get headerText():String public function set headerText(value:String):voidheaderWordWrap | propriété |
headerWordWrap:*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur est true pour enrouler le texte dans l’en-tête de colonne s’il ne tient pas sur une seule ligne. Si la valeur est undefined, la propriété wordWrap du contrôle AdvancedDataGrid est utilisée. Cette propriété remplace la propriété headerWordWrap du contrôle AdvancedDataGrid.
La valeur par défaut est undefined.
Implémentation
public function get headerWordWrap():* public function set headerWordWrap(value:any):voidimeMode | propriété |
imeMode:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie le mode IME (éditeur de méthode d’entrée). Le mode IME permet aux utilisateurs d’entrer du texte en chinois, japonais et coréen. Flex définit le mode IME lorsque l’événement itemFocusIn se produit et rétablit la valeur précédente lorsque l’événement itemFocusOut a lieu. La classe flash.system.IMEConversionMode définit des constantes pour les valeurs possibles de cette propriété.
La valeur par défaut est null. Dans ce cas, la valeur de la propriété imeMode du contrôle AdvancedDataGrid est utilisée.
Implémentation
public function get imeMode():String public function set imeMode(value:String):voidEléments de l’API associés
itemEditor | propriété |
public var itemEditor:IFactory| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fabrique de classe des instances de l’éditeur d’élément à utiliser pour la colonne lorsqu’elle est modifiable.
La valeur par défaut est le contrôle mx.controls.TextInput.
Eléments de l’API associés
itemRenderer | propriété |
itemRenderer:IFactory| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fabrique de classe des instances de rendu d’élément qui affichent les données de chaque élément de la colonne. Vous pouvez spécifier le composant d’un rendu d’élément supplémentaire, d’un rendu d’élément intégré ou d’un rendu d’élément personnalisé comme valeur pour cette propriété.
Le rendu d’élément par défaut est la classe AdvancedDataGridItemRenderer, qui affiche les données de l’élément sous forme de texte.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement itemRendererChanged .
Implémentation
public function get itemRenderer():IFactory public function set itemRenderer(value:IFactory):voidEléments de l’API associés
labelFunction | propriété |
labelFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction qui détermine le texte à afficher dans cette colonne. Par défaut, la colonne affiche le texte du champ de données correspondant au nom de la colonne. Toutefois, vous souhaiterez parfois afficher un texte composé du contenu de plusieurs champs de données ou un élément qui ne sera pas au format souhaité. Dans ce cas, spécifiez une fonction de rappel à l’aide de la fonction labelFunction.
Pour le contrôle AdvancedDataGrid, la signature de la méthode prend la forme suivante :
labelFunction(item:Object, column:AdvancedDataGridColumn):String
dans laquelle item contient l’objet de l’élément AdvancedDataGrid et column indique la colonne AdvancedDataGrid.
Une fonction de rappel peut concaténer les champs firstName et lastName des données, personnaliser la mise en forme d’une date ou convertir le nombre d’un mois en chaîne pour le mois.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelFunctionChanged .
Implémentation
public function get labelFunction():Function public function set labelFunction(value:Function):voidminWidth | propriété |
minWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur minimale de la colonne, en pixels.
La valeur par défaut est 20.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement minWidthChanged .
Implémentation
public function get minWidth():Number public function set minWidth(value:Number):voidrendererIsEditor | propriété |
public var rendererIsEditor:Boolean = false| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant que le rendu d’élément est également un éditeur d’élément. Si cette propriété a la valeur true, Flex ignore la propriété itemEditor et utilise le rendu d’élément de cet élément comme éditeur.
La valeur par défaut est false.
resizable | propriété |
public var resizable:Boolean = true| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur est true si l’utilisateur est autorisé à redimensionner la largeur de la colonne. Si la valeur est true, l’utilisateur peut faire glisser les lignes de la grille entre les en-têtes de colonne pour redimensionner la colonne.
La valeur par défaut est true.
showDataTips | propriété |
showDataTips:*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur est définie sur true pour afficher les astuces sur les données dans la colonne. Si la valeur est true, les astuces sur les données s’affichent pour le texte des rangées. Les astuces sur les données sont des infos-bulles conçues pour afficher le texte qui est trop long pour la rangée.
La valeur par défaut est false.
Implémentation
public function get showDataTips():* public function set showDataTips(value:any):voidsortable | propriété |
public var sortable:Boolean = true| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur est définie sur true pour indiquer que l’utilisateur peut cliquer sur l’en-tête de cette colonne pour trier le fournisseur de données. Si cette propriété et la propriété sortableColumns du contrôle AdvancedDataGrid sont toutes les deux définies sur true, le contrôle AdvancedDataGrid distribue un événement headerRelease lorsqu’un utilisateur relâche le bouton de la souris sur cet en-tête de colonne. Si aucun autre gestionnaire n’appelle la méthode preventDefault() sur l’événement headerRelease, la propriété dataField ou sortCompareFunction de la colonne est utilisée pour réorganiser les éléments dans le fournisseur de données.
La valeur par défaut est true.
sortCompareFunction | propriété |
sortCompareFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction de rappel appelée lors du tri des données dans la colonne. Si cette propriété n’est pas spécifiée, le tri essaie d’utiliser un tri de chaînes ou de nombres basique sur les données. Si les données ne sont ni des chaînes ni des nombres ou si la propriété dataField n’est pas une propriété valide du fournisseur de données, le tri ne fonctionne pas ou génère une exception. Si vous spécifiez une valeur pour la propriété labelFunction, vous devez également fournir une fonction pour la propriété sortCompareFunction, à moins que le tri ne soit pas autorisé dans cette colonne. Cela signifie que vous spécifiez une fonction lorsque la valeur de la colonne dataField ne trie pas de la même façon que la valeur calculée à partir de la propriété labelFunction.
Le contrôle AdvancedDataGrid utilise cette fonction pour trier les éléments dans la collection du fournisseur de données. La signature de la fonction de rappel utilise deux paramètres et possède la forme suivante :
mySortCompareFunction(obj1:Object, obj2:Object):int
obj1 — Elément de données à comparer.
obj2 — Autre élément de données à comparer à obj1.
La fonction doit renvoyer une valeur basée sur la comparaison des objets :
- -1 si obj1 doit apparaître avant obj2 par ordre croissant.
- 0 si obj1 = obj2.
- 1 si obj1 doit apparaître après obj2 par ordre croissant.
Remarque : les paramètres obj1 et obj2 sont des éléments entiers du fournisseur de données et pas uniquement les données de l’élément.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement sortCompareFunctionChanged .
Implémentation
public function get sortCompareFunction():Function public function set sortCompareFunction(value:Function):voidsortDescending | propriété |
public var sortDescending:Boolean = false| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si le tri de colonne s’effectue par ordre croissant (false) ou décroissant (true).
La valeur par défaut est false.
styleFunction | propriété |
styleFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction de rappel qui est appelée lors du rendu de chaque cellule. La signature de la fonction doit être :
function myStyleFunction(data:Object, column:AdvancedDataGridColumn):Object
data : objet de données associé à l’élément en cours de rendu.
column : instance AdvancedDataGridColumn à laquelle le rendu d’élément est associé.
La valeur renvoyée doit être un objet dont les styles sont des propriétés dotées des valeurs requises. Par exemple :
{ color:0xFF0000, fontWeight:"bold" }
Implémentation
public function get styleFunction():Function public function set styleFunction(value:Function):voidvisible | propriété |
visible:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Si la valeur est true, la colonne est visible. La valeur est définie sur false pour masquer la colonne.
La valeur par défaut est true.
Implémentation
public function get visible():Boolean public function set visible(value:Boolean):voidwidth | propriété |
width:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur de la colonne, en pixels. Si la propriété horizontalScrollPolicy du contrôle AdvancedDataGrid est définie sur false, toutes les colonnes visibles doivent s’adapter à la zone affichable et le contrôle AdvancedDataGrid ne respectera pas toujours la largeur des colonnes si la largeur totale des colonnes est trop petite ou trop grande pour la zone affichable.
La valeur par défaut est 100.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement widthChanged .
Implémentation
public function get width():Number public function set width(value:Number):voidwordWrap | propriété |
wordWrap:*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Lorsque la valeur est définie sur false, le texte est enroulé dans une rangée de cette colonne, car il ne tient pas sur une seule ligne. Si la valeur est undefined, la propriété wordWrap du contrôle AdvancedDataGrid est utilisée.
La valeur par défaut est undefined.
Implémentation
public function get wordWrap():* public function set wordWrap(value:any):voidAdvancedDataGridColumn | () | Constructeur |
public function AdvancedDataGridColumn(columnName:String = null)| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
ParamètrescolumnName:String (default = null)dataField et headerText.
|
clone | () | méthode |
public function clone():AdvancedDataGridColumn| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Clonez cette colonne et renvoyez une nouvelle colonne avec les mêmes propriétés et styles que celle-ci. Cela ne définit pas toutes les propriétés disponibles
Valeur renvoyéeAdvancedDataGridColumn — col AdvancedDataGridColumn.
|
itemToDataTip | () | méthode |
public function itemToDataTip(data:Object):String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie une chaîne que le rendu d’élément affiche sous forme d’astuce sur les données pour l’objet de données fourni, en fonction des propriétés dataTipField et dataTipFunction. Si la méthode ne peut pas convertir le paramètre en chaîne, elle renvoie un espace unique.
Cette méthode est utilisée par les développeurs qui créent des sous-classes de la classe AdvancedDataGridColumn. Elle n’est pas utilisée par les développeurs d’application.
Paramètres
data:Object — Objet à afficher.
|
String — Chaîne affichable en fonction des données.
|
itemToLabel | () | méthode |
public function itemToLabel(data:Object, withFormatting:Boolean = true):String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie la chaîne que le rendu d’élément affiche pour l’objet de données spécifié. Si l’objet AdvancedDataGridColumn ou son contrôle AdvancedDataGrid présente une propriété labelFunction non nulle, la fonction est appliquée à l’objet de données. Sinon, la méthode extrait le contenu du champ spécifié par la propriété dataField ou obtient la valeur de chaîne de l’objet de données. Si la méthode ne peut pas convertir le paramètre en chaîne, elle renvoie un espace unique.
Paramètres
data:Object — Objet à afficher.
| |
withFormatting:Boolean (default = true)true, la chaîne est renvoyée avec les mises en forme qui lui sont appliquées.
|
String — Chaîne affichable en fonction des données.
|
Tue Jun 12 2018, 09:30 AM Z