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 : Récupération des données du serveur...
Récupération des données du serveur...
mx.collections 

SummaryRow  - AS3 Flex

Packagemx.collections
Classepublic class SummaryRow
HéritageSummaryRow Inheritance Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La classe SummaryRow représente une ligne de résumé du contrôle AdvancedDataGrid. Vous pouvez créer des données de résumé concernant les groupes de données à l’aide de la propriété summaries de la classe GroupingField ou GroupingCollection. Les données de résumé sont affichées dans une ligne existante du contrôle AdvancedDataGrid ou dans une ligne séparée.

La propriété summaries de la classe GroupingField ou GroupingCollection accepte une instance de la classe SummaryRow. Vous pouvez ensuite utiliser la propriété fields de la classe SummaryRow pour spécifier un tableau contenant une ou plusieurs instances SummaryField2 définissant les champs des données utilisées pour créer le résumé. SummaryField2 doit être utilisé lorsque vous utilisez GroupingCollection2.

L’exemple suivant crée des lignes de résumé à partir de deux champs issus du fournisseur de données du contrôle AdvancedDataGrid :

  <mx:AdvancedDataGrid id="myADG" 
    initialize="gc.refresh();"> 
    <mx:dataProvider>
      <mx:GroupingCollection id="gc" source="{dpFlat}">
        <mx:Grouping>
          <mx:GroupingField name="Region">
            <mx:summaries>
              <mx:SummaryRow summaryPlacement="group">
                <mx:fields>
                  <mx:SummaryField dataField="Actual" 
                    label="Min Actual" operation="MIN"/>
                  <mx:SummaryField dataField="Actual" 
                    label="Max Actual" operation="MAX"/>
                </mx:fields>
              </mx:SummaryRow>
            </mx:summaries>
          </mx:GroupingField>
          <mx:GroupingField name="Territory">
            <mx:summaries>
              <mx:SummaryRow summaryPlacement="group">
                <mx:fields>
                  <mx:SummaryField dataField="Actual" 
                    label="Min Actual" operation="MIN"/>
                  <mx:SummaryField dataField="Actual" 
                    label="Max Actual" operation="MAX"/>
                </mx:fields>
              </mx:SummaryRow>
            </mx:summaries>
          </mx:GroupingField>
        </mx:Grouping>
      </mx:GroupingCollection>
    </mx:dataProvider> 
 
    <mx:columns>
      <mx:AdvancedDataGridColumn dataField="Region"/>
      <mx:AdvancedDataGridColumn dataField="Territory_Rep"
        headerText="Territory Rep"/>
      <mx:AdvancedDataGridColumn dataField="Actual"/>
      <mx:AdvancedDataGridColumn dataField="Estimate"/>
      <mx:AdvancedDataGridColumn dataField="Min Actual"/>
      <mx:AdvancedDataGridColumn dataField="Max Actual"/>
    </mx:columns>
  </mx:AdvancedDataGrid>
  

Syntaxe MXMLexpandedMasquer la syntaxe MXML
The <mx.SummaryRow> tag defines the following tag attributes:

  <mx:SummaryRow
  Properties 
    fields="No default"
    summaryObjectFunction="No default"
    summaryPlacement="last"
  />
  

Propriété MXML par défautfields

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  fields : Array
Tableau d’instances SummaryField/SummaryField2 définissant les caractéristiques des champs de données utilisés pour créer le résumé.
SummaryRow
  summaryObjectFunction : Function
Spécifie une fonction de rappel définissant l’objet de résumé, qui est une instance de la classe SummaryObject.
SummaryRow
  summaryPlacement : String = "last"
Spécifie la position d’affichage de la ligne de résumé dans le contrôle AdvancedDataGrid.
SummaryRow
Méthodes publiques
 MéthodeDéfini par
  
Constructeur.
SummaryRow
 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é

fields

propriété
public var fields:Array

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Tableau d’instances SummaryField/SummaryField2 définissant les caractéristiques des champs de données utilisés pour créer le résumé.

Eléments de l’API associés

summaryObjectFunction

propriété 
public var summaryObjectFunction:Function

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 une fonction de rappel définissant l’objet de résumé, qui est une instance de la classe SummaryObject. L’instance SummaryObject collecte les données de résumé à afficher dans le contrôle AdvancedDataGrid. Le contrôle AdvancedDataGrid ajoute l’instance SummaryObject au fournisseur de données pour afficher les données de résumé dans le contrôle. Par conséquent, vous devez définir les propriétés à afficher dans l’instance SummaryObject.

Utilisez cette propriété avec la propriété SummaryField.summaryFunction, qui définit une fonction de rappel permettant de réaliser le calcul de résumé.

La classe GroupingCollection ajoute à l’objet une propriété appelée children.

La fonction de rappel doit présenter la signature suivante :

function mySumObjFunc():SummaryObject {}

Eléments de l’API associés

summaryPlacement

propriété 
public var summaryPlacement:String = "last"

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 la position d’affichage de la ligne de résumé dans le contrôle AdvancedDataGrid. Valeurs possibles :

  • "first" : crée une ligne de résumé comme première ligne du groupe.
  • "last" : crée une ligne de résumé comme dernière ligne du groupe.
  • "group" : ajoute les données de résumé à la ligne correspondant au groupe.

Vous pouvez spécifier plusieurs valeurs, séparées par une espace. Par exemple, la valeur "last group" affiche la même ligne de résumé au niveau du groupe et dans la dernière ligne des enfants.

Détails du constructeur

SummaryRow

()Constructeur
public function SummaryRow()

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Constructeur.





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