blob: 600c489b242894feee072615100903e8edfa633b [file] [log] [blame]
{ "type": "class",
"qname": "mx.collections.SummaryField",
"baseClassname": ""
,
"description": "The SummaryField class represents a single property in a SummaryRow instance. Each SummaryRow instance specifies one or more SummayField instances that are used to create a data summary. <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>operation</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> <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:SummaryField dataField=&quot;Actual&quot;\\n label=&quot;Min Actual&quot; operation=&quot;MIN&quot;/&gt;\\n &lt;mx:SummaryField dataField=&quot;Actual&quot;\\n label=&quot;Max Actual&quot; operation=&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:SummaryField dataField=&quot;Actual&quot;\\n label=&quot;Min Actual&quot; operation=&quot;MIN&quot;/&gt;\\n &lt;mx:SummaryField dataField=&quot;Actual&quot;\\n label=&quot;Max Actual&quot; operation=&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> <p>This Class has been deprecated and replaced by a new Class <code>SummaryField2</code>. Properties <code>operation</code> and <code>summaryFunction</code> are not present in the Class <code>SummaryField2</code>. A new property <code>summaryOperation</code> is introduced in <code>SummaryField2</code>.</p>",
"tags": [
{ "tagName": "see",
"values": ["mx.controls.AdvancedDataGrid", "mx.collections.GroupingField", "mx.collections.SummaryRow"]},
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "tagName": "langversion",
"values": ["3.0"]},
{ "tagName": "royalesuppresspublicvarwarning",
"values": []} ],
"members": [
{ "type": "method",
"qname": "mx.collections.SummaryField",
"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>.",
"tags": [
{ "tagName": "param",
"values": ["dataField Data field for which the summary is computed.", "operation The function that should be performed on the children."]},
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"return": "",
"params": [{ "name": "dataField", "type": "String"},
{ "name": "operation", "type": "String"}]}
,
{ "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 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "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 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "operation",
"return": "String",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The function that should be performed on the children. 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>.",
"tags": [
{ "tagName": "default",
"values": ["SUM"]},
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "summaryFunction",
"return": "Function",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Specifies a callback function to compute a custom data summary. <p>You use this property with the <code>SummaryRow.summaryObjectFunction</code> property, which defines an instance of the SummaryObject class used to collect summary data for display in the AdvancedDataGrid control.</p> <p>The function signature should be as follows:</p> <pre>\\n function mySummaryFunction(iterator:IViewCursor, dataField:String, operation:String):Object</pre> <p>The built-in summary functions for <code>SUM</code>, <code>MIN</code>, <code>MAX</code>, <code>AVG</code>, and <code>COUNT</code> all return a Number containing the summary data. </p>",
"tags": [
{ "tagName": "see",
"values": ["mx.collections.SummaryObject", "mx.collections.SummaryRow#summaryObjectFunction"]},
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["Flex 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]}]
}