com.smartgwt.client.widgets

## Class UserFormula

- java.lang.Object
- - com.smartgwt.client.core.JsObject
  - - com.smartgwt.client.core.DataClass
    - - com.smartgwt.client.widgets.UserFormula

- All Implemented Interfaces:
    com.google.gwt.event.shared.HasHandlers

      public class UserFormula
      extends DataClass

  An object representing a user-created and user-modifiable formula, which can be created and edited with a FormulaBuilder either directly or via the `ListGrid.canAddFormulaFields` behavior.

- - ### Field Summary

    - ### Fields inherited from class com.smartgwt.client.core.DataClass

      `factoryCreated, factoryProperties, readOnly`

    - ### Fields inherited from class com.smartgwt.client.core.JsObject

      `jsObj`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `UserFormula()`
    `UserFormula(com.google.gwt.core.client.JavaScriptObject jsObj)`
    `UserFormula(java.lang.String text)`
    `UserFormula(java.lang.String text, java.util.Map formulaVars)`

  - ### Method Summary

    All Methods Static Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `java.util.Map` | `getFormulaVars()` Object mapping from variable names to fieldNames.
    `static UserFormula` | `getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)`
    `java.lang.String` | `getText()` Formula to be evaluated.
    `void` | `setFormulaVars(java.util.Map formulaVars)` Object mapping from variable names to fieldNames.
    `void` | `setText(java.lang.String text)` Formula to be evaluated.

    - ### Methods inherited from class com.smartgwt.client.core.DataClass

      `applyFactoryProperties, doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, getReadOnly, isFactoryCreated, logConfiguration, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreated, setReadOnly`

    - ### Methods inherited from class com.smartgwt.client.core.JsObject

      `equals, getJsObj, hashCode, isCreated, setJavaScriptObject, setJsObj`

    - ### Methods inherited from class java.lang.Object

      `clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### UserFormula

          public UserFormula()

    - #### UserFormula

          public UserFormula(com.google.gwt.core.client.JavaScriptObject jsObj)

    - #### UserFormula

          public UserFormula(java.lang.String text)

    - #### UserFormula

          public UserFormula(java.lang.String text,
                             java.util.Map formulaVars)

  - ### Method Detail

    - #### getOrCreateRef

          public static UserFormula getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)

    - #### setFormulaVars

          public void setFormulaVars(java.util.Map formulaVars)

      Object mapping from variable names to fieldNames. All variable names must be single-letter capital characters (eg A). For example, for a formula that should divide the field "population" over the field "area", the formula might be "E/L" and formula vars would be:

              Map vars = new HashMap();
              vars.put("E", "population");
              vars.put("L", "area");

      When used in `ListGridField.userFormula` context, field names are evaluated against the grid record.

      When used in `FormItem.formula` or `ListGridField.editorFormula` this property is not used for formula mapping. Instead, field names are evaluated directly against the current `rule context`.

      Parameters:
        `formulaVars` - Default value is null

    - #### getFormulaVars

          public java.util.Map getFormulaVars()

      Object mapping from variable names to fieldNames. All variable names must be single-letter capital characters (eg A). For example, for a formula that should divide the field "population" over the field "area", the formula might be "E/L" and formula vars would be:

              Map vars = new HashMap();
              vars.put("E", "population");
              vars.put("L", "area");

      When used in `ListGridField.userFormula` context, field names are evaluated against the grid record.

      When used in `FormItem.formula` or `ListGridField.editorFormula` this property is not used for formula mapping. Instead, field names are evaluated directly against the current `rule context`.

      Returns:
        Map

    - #### setText

          public void setText(java.lang.String text)

      Formula to be evaluated.

      There are two contexts where a UserFormula is used: `ListGridField.userFormula` and `FormItem.formula` or `ListGridField.editorFormula`. For the grid field formula all variables used by the formula must be single-letter capital characters (eg A). These are derived from field values for the record in question - see `formulaVars`.

      In addition to these variables, the keyword `record` may be used to refer directly to the record for which the formula is being displayed.

      In the second usage context variables are dot-separated (.) names representing the nested hierarchy path to the desired value within the `rule context`. No mapping with `formulaVars` is needed.

      Parameters:
        `text` - Default value is null

    - #### getText

          public java.lang.String getText()

      Formula to be evaluated.

      There are two contexts where a UserFormula is used: `ListGridField.userFormula` and `FormItem.formula` or `ListGridField.editorFormula`. For the grid field formula all variables used by the formula must be single-letter capital characters (eg A). These are derived from field values for the record in question - see `formulaVars`.

      In addition to these variables, the keyword `record` may be used to refer directly to the record for which the formula is being displayed.

      In the second usage context variables are dot-separated (.) names representing the nested hierarchy path to the desired value within the `rule context`. No mapping with `formulaVars` is needed.

      Returns:
        String