blob: d83015ab5bdf09197a0de4d53086ad2f84463169 [file] [log] [blame]
{ "type": "class",
"qname": "mx.collections.SummaryField2",
"baseClassname": ""
,
"description": "The SummaryField2 class represents a single property in a SummaryRow instance. Each SummaryRow instance specifies one or more SummayField2 instances that are used to create a data summary. <p><b>Note: </b>In the previous release of Flex, you used the SummaryField class to create summary data. The SummaryField2 class is new for Flex 4 and provides better performance than SummaryField.</p> <p>Use the <code>dataField</code> property to specify the data field used to generate the summary, the <code>label</code> property to specify the name of the data field created to hold the summary data, and the <code>summaryOperation</code> property to specify how to create the summary for numeric fields. You can specify one of the following values: <code>SUM</code>, <code>MIN</code>, <code>MAX</code>, <code>AVG</code>, or <code>COUNT</code>.</p> Or you can specify an ISummaryCalculator implementation to calculate the summaries. <p>The following example creates summary rows based on two fields of the data provider of the AdvancedDataGrid control:</p> <pre>\\n &lt;mx:AdvancedDataGrid id=&quot;myADG&quot;\\n initialize=&quot;gc.refresh();&quot;&gt;\\n &lt;mx:dataProvider&gt;\\n &lt;mx:GroupingCollection id=&quot;gc&quot; source=&quot;{dpFlat}&quot;&gt;\\n &lt;mx:Grouping&gt;\\n &lt;mx:GroupingField name=&quot;Region&quot;&gt;\\n &lt;mx:summaries&gt;\\n &lt;mx:SummaryRow summaryPlacement=&quot;group&quot;&gt;\\n &lt;mx:fields&gt;\\n &lt;mx:SummaryField2 dataField=&quot;Actual&quot;\\n label=&quot;Min Actual&quot; summaryOperation=&quot;MIN&quot;/&gt;\\n &lt;mx:SummaryField2 dataField=&quot;Actual&quot;\\n label=&quot;Max Actual&quot; summaryOperation=&quot;MAX&quot;/&gt;\\n &lt;/mx:fields&gt;\\n &lt;/mx:SummaryRow&gt;\\n &lt;/mx:summaries&gt;\\n &lt;/mx:GroupingField&gt;\\n &lt;mx:GroupingField name=&quot;Territory&quot;&gt;\\n &lt;mx:summaries&gt;\\n &lt;mx:SummaryRow summaryPlacement=&quot;group&quot;&gt;\\n &lt;mx:fields&gt;\\n &lt;mx:SummaryField2 dataField=&quot;Actual&quot;\\n label=&quot;Min Actual&quot; summaryOperation=&quot;MIN&quot;/&gt;\\n &lt;mx:SummaryField2 dataField=&quot;Actual&quot;\\n label=&quot;Max Actual&quot; summaryOperation=&quot;MAX&quot;/&gt;\\n &lt;/mx:fields&gt;\\n &lt;/mx:SummaryRow&gt;\\n &lt;/mx:summaries&gt;\\n &lt;/mx:GroupingField&gt;\\n &lt;/mx:Grouping&gt;\\n &lt;/mx:GroupingCollection&gt;\\n &lt;/mx:dataProvider&gt;\\n \\n &lt;mx:columns&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Region&quot;/&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Territory_Rep&quot;\\n headerText=&quot;Territory Rep&quot;/&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Actual&quot;/&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Estimate&quot;/&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Min Actual&quot;/&gt;\\n &lt;mx:AdvancedDataGridColumn dataField=&quot;Max Actual&quot;/&gt;\\n &lt;/mx:columns&gt;\\n &lt;/mx:AdvancedDataGrid&gt;\\n </pre> The <code>&lt;mx.SummaryField2&gt;</code> inherits all the tag attributes of its superclass, and defines the following tag attributes:</p> <pre>\\n &lt;mx:SummaryField2\\n <b>Properties </b>\\n dataField=&quot;<i>No default</i>&quot;\\n label=&quot;<i>No default</i>&quot;\\n summaryOperation=&quot;<i>SUM</i>&quot;\\n /&gt;\\n </pre>",
"tags": [
{ "tagName": "see",
"values": ["mx.controls.AdvancedDataGrid", "mx.collections.GroupingField", "mx.collections.SummaryRow"]},
{ "tagName": "mxml",
"values": []},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "productversion",
"values": ["Flex 4"]},
{ "tagName": "langversion",
"values": ["3.0"]},
{ "tagName": "royalesuppresspublicvarwarning",
"values": []} ],
"members": [
{ "type": "method",
"qname": "mx.collections.SummaryField2",
"namespace": "",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Constructor. You can specify one of the following values for numeric fields: <code>SUM</code>, <code>MIN</code>, <code>MAX</code>, <code>AVG</code>, or <code>COUNT</code>. Or you can specify an ISummaryCalculator implementation to calculate the summaries.",
"tags": [
{ "tagName": "param",
"values": ["dataField Data field for which the summary is computed.", "summaryOperation The function that should be performed on the children."]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "productversion",
"values": ["Flex 4"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"return": "",
"params": [{ "name": "dataField", "type": "String"},
{ "name": "summaryOperation", "type": "Object"}]}
,
{ "type": "field",
"qname": "dataField",
"return": "String",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Data field for which the summary is computed.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "productversion",
"values": ["Flex 4"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "label",
"return": "String",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The property used inside the summary object, an instance of the SummaryObject class, to hold summary information. <p>For example, if you set the <code>label</code> property to &quot;Summary&quot;, then the computed summary is placed in a property named &quot;Summary&quot; in the summary object. The property of the SummaryObject instance containing the summary data will appear as below:</p> <pre>{Summary:1000}</pre>",
"tags": [
{ "tagName": "see",
"values": ["mx.collections.SummaryObject", "mx.collections.SummaryRow#summaryObjectFunction", "#summaryFunction"]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "productversion",
"values": ["Flex 4"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "summaryOperation",
"return": "Object",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The summary performed on the children. The value of this property can be one of the following: <ul> <li>For numeric fields: <code>SUM</code>, <code>MIN</code>, <code>MAX</code>, <code>AVG</code>, or <code>COUNT</code>.</li> <li>An instance of a class that implements the custom ISummaryCalculator interface to calculate a custom summary.</li> </ul>",
"tags": [
{ "tagName": "default",
"values": ["SUM"]},
{ "tagName": "see",
"values": ["mx.collections.ISummaryCalculator"]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "productversion",
"values": ["Flex 4"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]}]
}