Framework JavaScript ACube V2.10.0
 

Classe ComposantTableur

Object
   |
   +--ComposantTableur

class ComposantTableur


La classe «ComposantTableur» est la classe permettant de décrire l'objet associé à un tableur.
Ses propriétés publiques décrivent les attributs du composant et peut être manipulée ou interrogée en dehors de la bibliothèque du framework ergonomique. Ses propriétés privées sont utilisées au sein même du framework ergonomique.







RENDU IHM

Tableur utilisant le principe de regroupement par titre (les valeurs communes à tous les éléments dans une même colonne) :

Exemple IHM tableur

Exemple d'utilisation du composant Tableur.

Date: 28/09/2006

Version: 2.3

Fichiers JS nécessaires:

Definie dans ergonomique/fw_tableur.js

Fichiers CSS nécessaires:


Sommaire des Attributs
<private>  String argc
          L'élément «argc» dans la classe ComposantTableau n'est pas une propriété, il permet de récupérer le nombre d'arguments passés en paramètres du constructeur de la classe (utile dans le cas des paramètres facultatifs, pour compter les paramètres soumis par le développeur).
<private>  String argv
          L'élément «argv» dans la classe ComposantTableau n'est pas une propriété, il permet de récupérer dans un tableau les arguments passés en paramètres du constructeur de la classe (utile dans le cas des paramètres facultatifs, pour repérer les paramètres qui ont été soumis par le développeur).
<private>  boolean boolFiltrageTitreEnCours
          La propriété privée «boolFiltrageTitreEnCours» est un booléen précisant si un filtrage sur les titres est en cours ou pas.
<private>  String computeMapManager
          This private property «computeMapManager» refers an array of total and sub-total 's group.
<private>  booleen estTableur
          Attribut privé «estTableur» - booleen signifiant que l'objet est un tableur

<private>  Array_String filtresTitreNiveau1
          La propriété privée «filtreTitreNiv1» est un tableau de chaines de caractères contenant le libellé du titre de niveau 1 d'un filtre sur groupement.
Un filtre sur groupement est un triplet de trois valeurs : un libellé de niveau 1, de niveau 2 et de niveau 3 définis dans les attributs filtresTitreNiveau1, filtresTitreNiveau2 et filtreTitreNiveau3.
<private>  Array_String filtresTitreNiveau2
          La propriété privée «filtreTitreNiv2» est un tableau de chaines de caractères contenant le libellé du titre de niveau 2 d'un filtre sur groupement.
Un filtre sur groupement est un triplet de trois valeurs : un libellé de niveau 1, de niveau 2 et de niveau 3 définis dans les attributs filtresTitreNiveau1, filtresTitreNiveau2 et filtreTitreNiveau3.
<private>  Array_String filtresTitreNiveau3
          La propriété privée «filtreTitreNiv3» est un tableau de chaines de caractères contenant le libellé du titre de niveau 3 d'un filtre sur groupement.
Un filtre sur groupement est un triplet de trois valeurs : un libellé de niveau 1, de niveau 2 et de niveau 3 définis dans les attributs filtresTitreNiveau1, filtresTitreNiveau2 et filtreTitreNiveau3.
<private>  String groupe1
          Propriété privée «groupe1» - C'est le nom de la donnée devant servir de critére de regroupement de 1° niveau.
<private>  String groupe2
          Propriété privée «groupe2» - C'est le nom de la donnée devant servir de critére de regroupement de 2° niveau.
<private>  String groupe3
          Propriété privée «groupe3» - C'est le nom de la donnée devant servir de critére de regroupement de 3° niveau.
<private>  String LastValueGroupe1
          Propriété privée «LastValueGroupe1» - C'est la derniére valeur lue pour le critére de regoupement de 1° niveau.
<private>  String LastValueGroupe2
          Propriété privée «LastValueGroupe2» - C'est la derniére valeur lue pour le critére de regoupement de 2° niveau.
<private>  String LastValueGroupe3
          Propriété privée «LastValueGroupe3» - C'est la derniére valeur lue pour le critére de regoupement de 3° niveau.
<private>  Array_ObjectCalcul tabCalculs
          Propriété privée «tabCalculs» - Tableau d'objets ObjectCalcul contient les informations de définition des calculs à effectués pour les regroupements.
<private>  Array_ObjectOutilTab tabObjectOutilTri
          Attribut privé «tabCalculs» - Tableau d'objets ObjectOutilTab contient les différents objets de tri qui peuvent être affichés dans la barre d'outils :
Par exemple : passage du tri croissant à décroissant : les images onMouseOut et onMouseOver sont spécifiques.
<private>  String tabPercentage
          This private property «computeMapManager» refers an array of total and sub-total 's group post expressed as a percentage.
<private>  String totalPosition
          This private property «totalPosition» modulates the display of total and sub-total 's group.
 Object typeTri
          
<private>  String urlFiltreTitres
          La propriété privée «urlFiltreTitres» est une chaine de caractères contenant l'url de la popup utilisée pour le filtrage du tableur par titres.
 
Sommaire des Constructeurs
ComposantTableur (<String_Obligatoire> id, <XMLObjectSauvegarde_Facultatif> XMLObjectInfos, <String_Facultatif> urlXMLData, <boolean_Facultatif> boolMessageAttente, <boolean_Facultatif> boolListe)
            Crée une nouvelle instance de la classe ComposantTableur pour un tableur : Exemples d'appels aux constructeurs.
 
Sommaire des Méthodes
 <private>  void compute(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes, <integer_Obligatoire> cIndice, <array_Obligatoire> itemLignes)
           This private method «ComposantTableur_compute()» compute total's values for all group and calls setCalcul method.
 <private>  void computeFirstGroupPercent(computePercentTab, tmp)
           This private method «doFirstGroupPercent()» compute total's pourcent for one group.
 <private>  void computePercentage()
           This private method «ComposantTableur_computePercent()» compute all total's pourcent by group.
 <private>  void computePercentByGroup(<integer_Obligatoire> level, <array_Obligatoire> computePercent, <array_Obligatoire> groupArray)
           This private method «computePercentByGroup()» compute all total's pourcent by group.
 <private>  string displayCalcul(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)
           This private method «ComposantTableur_ecrireHTML_displayCalcul())» generate a display a total line when <CALCULS_POSITION > tag' value is 'bottom' or <CALCULS_POSITION > is empty
 <private>  string displayGroup(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)
           This private method «ComposantTableur_ecrireHTML_displayGroup())» generate a display group line with totals when <CALCULS_POSITION > tag' value is 'top'
 <private>  string displayLines(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes, <integer_Obligatoire> i, <array_Obligatoire> itemLignes)
           This private method «ComposantTableur_displayLines())» call all display methods in order to generate :
-group lines ( displayTopGroup method [calculposition='top'] and {@link #ComposantTableur_ecrireHTML_Groupe displayBottomGroup [calculposition='bottom'])
-total lines (displayCalcul)
-data lines (ecrireComposantDomHTMLZoneLigne)
 Object displayPercent(col, id, value)
          
 <private>  void doCellAverageUpdating(<String_Obligatoire> niveau, <Element_Obligatoire> totalElement, <Array_Obligatoire> tab, <String_Obligatoire> col)
           This private method «ComposantTableur_doCellAverageUpdating()» realize an average with an array of float number.
 <private>  void doCellSumUpdating(<String_Obligatoire> niveau, <Element_Obligatoire> totalElement, <Array_Obligatoire> tab, <String_Obligatoire> col)
           This private method «ComposantTableur_doCellSumUpdating()» realize a sum with an array of float number.
 <private>  string ecrireComposantDomHTMLBoucle(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes)
           La méthode publique «ecrireComposantDomHTMLBoucle())» associée au composant Tableaur.
 <private>  string ecrireComposantDomHTMLZoneCalcul(<integer_Obligatoire> niveau, <String_Obligatoire> valeur)
           La méthode privée «ecrireComposantDomHTMLZoneCalcul())» génére de résultat de calcul pour un groupement du tableur.
 <private>  string ecrireComposantDomHTMLZoneGroupe(<integer_Obligatoire> niveau, <String_Obligatoire> valeur)
           La méthode privée «ecrireComposantDomHTMLZoneGroupe())» génére une ligne de regourpement du tableur.
 <private>  string ecrireComposantDomHTMLZoneInfo()
           La méthode privée «ecrireComposantDomHTMLZoneInfo())» génére de résultat de calcul pour un groupement du tableur.
 void excelExportBoucle(<String_Obligatoire> form, <int_Obligatoire> nbLines)
           This method is use by the Excel/CSV export.
 void excelExportCalcul(<int_Obligatoire> level, <String_Obligatoire> value, <String_Obligatoire> form, <int_Obligatoire> line)
           This method is use by the Excel/CSV export.
 void excelExportGroupe(<int_Obligatoire> level, <String_Obligatoire> value, <String_Obligatoire> form, <int_Obligatoire> line)
           This method is use by the Excel/CSV export.
 void excelExportTotal(<String_Obligatoire> form)
           This method is use by the Excel/CSV export.
 <private>  boolean existeFiltreTitre(<String_Obligatoire> titre1, <String_Obligatoire> titre2, <String_Obligatoire> titre3)
           La méthode privée «existeFiltreTitre(titre1, titre2, titre3)» est appelée pour tester si un un triplet titre1, titre2 et titre3 existe dans la liste des filtres sur groupement.
 Object extend_ComposantTableau(<String_Obligatoire> id, <XMLObjectSauvegarde_Facultatif> XMLObjectInfos, <String_Facultatif> urlXMLData, <boolean_Obligatoire> boolMessageAttente, <boolean_Obligatoire> boolListe)
           Crée une nouvelle instance de la classe ComposantTableau pour un tableau : Exemples d'appels aux constructeurs.
 <private>  void incrementTabCalculs(<array_Obligatoire> itemlignesi)
           This private method «ComposantTableur_incrementTabCalculs()» call incrementeCalcul for all ObjectCalcul() contained into {@ling tabCalcul tabCalcul attribut}
 <private>  void initInfosGroupeByXML()
           La méthode privée «initInfosGroupeByXML()» initialise les attributs paramétrables du composant tableur à partir d'un flux XML.
 <private>  Array_String listerTitres(<titre1_Facultatif> titre1,<titre2_Facultatif> titre2)
           La méthode privée «listerTitres(titre1,titre2)» permet de récupérer les titres uniques de niveau 1,2ou3.
 <private>  void onClickGroupe(<Object_Facultatif> tabLigneCourante,<Object_Facultatif> imageCourante)
           La méthode privée «onClickGroupe(imageCourante)» est déclenchée depuis l'action HTML onclick sur les images d'expansion (signe + ou -) ou non de partie.
Elle fait passer l'image de + à - ou vis versa.
 <private>  void onMouseOutGroupe(<Object_Obligatoire> imageCourante)
           La méthode privée «onMouseOutGroupe(imageCourante)» est déclenchée depuis l'action HTML onMouseOut sur les images d'expansion (signe + ou -) ou non de partie.
Elle modifie l'image au départ de la souris, améliorant ainsi l'ergonomie de l'application.
 <private>  void onMouseOverGroupe(<Object_Obligatoire> imageCourante)
           La méthode privée «onMouseOverGroupe(imageCourante)» est déclenchée depuis l'action HTML onMouseOver sur les images d'expansion (signe + ou -) ou non de partie.
Elle modifie l'image au passage de la souris, améliorant ainsi l'ergonomie de l'application.
 <private>  void ouvrirFiltreTitres()
           La méthode privée «ouvrirFiltreTitres()» est déclenchée depuis l'image de filtre affichée si la balise XML est renseignée dans les OUTILS.
 <private>  void resetTabCalculs(<integer_Obligatoire> value)
           This private method «ComposantTableur_resetTabCalculs()» puts at zero the ObjectCalcul into {@ling tabCalcul tabCalcul attribut} corresponding to the level of group
 <private>  string setCalcul(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)
           This private method «ComposantTableur_getGroupCalcul()» fills the map.
 <private>  void setPositionCalcul(<ELEMENT_Obligatoire> node)
           This private method «ComposantTableur_setPositionCalcul()» initialized the calcul position attribute.
 <private>  boolean testFiltreTitre(<int_Obligatoire> item)
           La méthode privée «testFiltreTitre(item)» est appelée pour tester si une ligne respecte les filtres sur les groupements associés au tableur.
 <private>  void triTableur(<String_Obligatoire> ordre)
           La méthode privée «triTableur()» est déclenchée depuis l'image de tri affichée si la balise XML est renseignée.
 void updateCellTotal(<String_Obligatoire> id, <String_Obligatoire> group, <String_Obligatoire> subtype, <String_Obligatoire> type_name, <String_Obligatoire> col, <Element_Obligatoire> element, <Element_Obligatoire> total1, <Element_Obligatoire> total2, <Element_Obligatoire> total3, <Element_Obligatoire> total)
           This private method «ComposantTableur_updateCellTotal()» is called by ComposantTableur_updateDataCascade compute total's values for
 <private>  void updateDataCascade(<String_Obligatoire> id)
           La méthode privée «ComposantTableur_updateDataCascade» permet de déclencher la mise à jour lors de l'édition d'une cellule

Détail des Attributs

argc

<private> String argc

argv

<private> String argv

boolFiltrageTitreEnCours

<private> boolean boolFiltrageTitreEnCours

computeMapManager

<private> String computeMapManager

estTableur

<private> booleen estTableur

filtresTitreNiveau1

<private> Array_String filtresTitreNiveau1

filtresTitreNiveau2

<private> Array_String filtresTitreNiveau2

filtresTitreNiveau3

<private> Array_String filtresTitreNiveau3

groupe1

<private> String groupe1

groupe2

<private> String groupe2

groupe3

<private> String groupe3

LastValueGroupe1

<private> String LastValueGroupe1

LastValueGroupe2

<private> String LastValueGroupe2

LastValueGroupe3

<private> String LastValueGroupe3

tabCalculs

<private> Array_ObjectCalcul tabCalculs

tabObjectOutilTri

<private> Array_ObjectOutilTab tabObjectOutilTri

tabPercentage

<private> String tabPercentage

totalPosition

<private> String totalPosition

typeTri

Object typeTri

urlFiltreTitres

<private> String urlFiltreTitres

Détail des Constructeurs

ComposantTableur

ComposantTableur(<String_Obligatoire> id, <XMLObjectSauvegarde_Facultatif> XMLObjectInfos, <String_Facultatif> urlXMLData, <boolean_Facultatif> boolMessageAttente, <boolean_Facultatif> boolListe)

Détail des Méthodes

compute

 <private> void compute(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes, <integer_Obligatoire> cIndice, <array_Obligatoire> itemLignes)

computeFirstGroupPercent

 <private> void computeFirstGroupPercent(computePercentTab, tmp)

computePercentage

 <private> void computePercentage()

computePercentByGroup

 <private> void computePercentByGroup(<integer_Obligatoire> level, <array_Obligatoire> computePercent, <array_Obligatoire> groupArray)

displayCalcul

 <private> string displayCalcul(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)

displayGroup

 <private> string displayGroup(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)

displayLines

 <private> string displayLines(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes, <integer_Obligatoire> i, <array_Obligatoire> itemLignes)

displayPercent

Object displayPercent(col, id, value)

doCellAverageUpdating

 <private> void doCellAverageUpdating(<String_Obligatoire> niveau, <Element_Obligatoire> totalElement, <Array_Obligatoire> tab, <String_Obligatoire> col)

doCellSumUpdating

 <private> void doCellSumUpdating(<String_Obligatoire> niveau, <Element_Obligatoire> totalElement, <Array_Obligatoire> tab, <String_Obligatoire> col)

ecrireComposantDomHTMLBoucle

 <private> string ecrireComposantDomHTMLBoucle(<integer_Obligatoire> minLignes, <integer_Obligatoire> maxLignes)

ecrireComposantDomHTMLZoneCalcul

 <private> string ecrireComposantDomHTMLZoneCalcul(<integer_Obligatoire> niveau, <String_Obligatoire> valeur)

ecrireComposantDomHTMLZoneGroupe

 <private> string ecrireComposantDomHTMLZoneGroupe(<integer_Obligatoire> niveau, <String_Obligatoire> valeur)

ecrireComposantDomHTMLZoneInfo

 <private> string ecrireComposantDomHTMLZoneInfo()

excelExportBoucle

void excelExportBoucle(<String_Obligatoire> form, <int_Obligatoire> nbLines)

excelExportCalcul

void excelExportCalcul(<int_Obligatoire> level, <String_Obligatoire> value, <String_Obligatoire> form, <int_Obligatoire> line)

excelExportGroupe

void excelExportGroupe(<int_Obligatoire> level, <String_Obligatoire> value, <String_Obligatoire> form, <int_Obligatoire> line)

excelExportTotal

void excelExportTotal(<String_Obligatoire> form)

existeFiltreTitre

 <private> boolean existeFiltreTitre(<String_Obligatoire> titre1, <String_Obligatoire> titre2, <String_Obligatoire> titre3)

extend_ComposantTableau

Object extend_ComposantTableau(<String_Obligatoire> id, <XMLObjectSauvegarde_Facultatif> XMLObjectInfos, <String_Facultatif> urlXMLData, <boolean_Obligatoire> boolMessageAttente, <boolean_Obligatoire> boolListe)

incrementTabCalculs

 <private> void incrementTabCalculs(<array_Obligatoire> itemlignesi)

initInfosGroupeByXML

 <private> void initInfosGroupeByXML()

listerTitres

 <private> Array_String listerTitres(<titre1_Facultatif> titre1,<titre2_Facultatif> titre2)

onClickGroupe

 <private> void onClickGroupe(<Object_Facultatif> tabLigneCourante,<Object_Facultatif> imageCourante)

onMouseOutGroupe

 <private> void onMouseOutGroupe(<Object_Obligatoire> imageCourante)

onMouseOverGroupe

 <private> void onMouseOverGroupe(<Object_Obligatoire> imageCourante)

ouvrirFiltreTitres

 <private> void ouvrirFiltreTitres()

resetTabCalculs

 <private> void resetTabCalculs(<integer_Obligatoire> value)

setCalcul

 <private> string setCalcul(<integer_Obligatoire> niveau, <integer_Obligatoire> valeur)

setPositionCalcul

 <private> void setPositionCalcul(<ELEMENT_Obligatoire> node)

testFiltreTitre

 <private> boolean testFiltreTitre(<int_Obligatoire> item)

triTableur

 <private> void triTableur(<String_Obligatoire> ordre)

updateCellTotal

void updateCellTotal(<String_Obligatoire> id, <String_Obligatoire> group, <String_Obligatoire> subtype, <String_Obligatoire> type_name, <String_Obligatoire> col, <Element_Obligatoire> element, <Element_Obligatoire> total1, <Element_Obligatoire> total2, <Element_Obligatoire> total3, <Element_Obligatoire> total)

updateDataCascade

 <private> void updateDataCascade(<String_Obligatoire> id)

Framework JavaScript ACube V2.10.0
 

Version 2.10.0, / Etat : Validé
Cette création est mise à disposition selon le Contrat Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique disponible en ligne http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ ou par courrier postal à Creative Commons, 559 Nathan Abbott Way, Stanford,California 94305, USA.


Documentation generated by JSDoc on Wed Jan 6 17:05:02 2010