com.smartgwt.client.tools

## Class PaletteNode

- java.lang.Object
- - com.smartgwt.client.core.JsObject
  - - com.smartgwt.client.core.DataClass
    - - com.smartgwt.client.core.RefDataClass
      - - com.smartgwt.client.data.Record
        - - com.smartgwt.client.tools.PaletteNode

- Direct Known Subclasses:
    EditNode

      public class PaletteNode
      extends Record

  An object representing a component which the user may create dynamically within an application.

  A PaletteNode expresses visual properties for how the palette will display it (eg `title`, `icon`) as well as instructions for creating the component the paletteNode represents (`type`, `defaults`).

  Various types of palettes (`ListPalette`, `TreePalette`, `MenuPalette`, `TilePalette`) render a PaletteNode in different ways, and allow the user to trigger creation in different ways (eg drag and drop, or just click). All share a common pattern for how components are created from palettes.

  Note that in a TreePalette, a PaletteNode is essentially a `TreeNode` and can have properties expected for a TreeNode (eg, `showDropIcon`. Likewise a PaletteNode in a MenuPalette can have the properties of a `MenuItem`, such as `MenuItem.enableIf()`.

- - ### Field Summary

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

      `id`

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

      `jsObj`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `PaletteNode()`
    `PaletteNode(com.google.gwt.core.client.JavaScriptObject jsObj)`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `Canvas` | `getCanvasDefaults()` Defaults for the component to be created from this palette.
    `Canvas` | `getCanvasLiveObject()` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `DrawItem` | `getDrawItemDefaults()` Defaults for the component to be created from this palette.
    `DrawItem` | `getDrawItemLiveObject()` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `FormItem` | `getFormItemDefaults()` Defaults for the component to be created from this palette.
    `FormItem` | `getFormItemLiveObject()` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `java.lang.String` | `getIcon()` Icon for this paletteNode.
    `static PaletteNode` | `getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)`
    `java.lang.String` | `getTitle()` Textual title for this paletteNode.
    `java.lang.String` | `getType()` String this paletteNode creates, for example, "ListGrid".
    `void` | `setCanvasDefaults(Canvas defaults)` Defaults for the component to be created from this palette.
    `void` | `setCanvasLiveObject(Canvas liveObject)` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `void` | `setDrawItemDefaults(DrawItem defaults)` Defaults for the component to be created from this palette.
    `void` | `setDrawItemLiveObject(DrawItem liveObject)` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `void` | `setFormItemDefaults(FormItem defaults)` Defaults for the component to be created from this palette.
    `void` | `setFormItemLiveObject(FormItem liveObject)` For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.
    `void` | `setIcon(java.lang.String icon)` Icon for this paletteNode.
    `void` | `setTitle(java.lang.String title)` Textual title for this paletteNode.
    `void` | `setType(java.lang.String type)` String this paletteNode creates, for example, "ListGrid".

    - ### Methods inherited from class com.smartgwt.client.data.Record

      `convertToRecordArray, copyAttributes, copyAttributesInto, getAttributeAsRecordArray, getAttributeAsRecordList, isARecord, toMap`

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

      `getRef, getRef, internalSetID`

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

      `doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, 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`

    - ### 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

    - #### PaletteNode

          public PaletteNode()

    - #### PaletteNode

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

  - ### Method Detail

    - #### getOrCreateRef

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

    - #### setCanvasDefaults

          public void setCanvasDefaults(Canvas defaults)

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Parameters:
        `defaults` - Default value is null

    - #### getCanvasDefaults

          public Canvas getCanvasDefaults()

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Returns:
        Canvas

    - #### setCanvasLiveObject

          public void setCanvasLiveObject(Canvas liveObject)

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Parameters:
        `liveObject` - Default value is null

    - #### getCanvasLiveObject

          public Canvas getCanvasLiveObject()

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Returns:
        Canvas

    - #### setDrawItemDefaults

          public void setDrawItemDefaults(DrawItem defaults)

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Parameters:
        `defaults` - Default value is null

    - #### getDrawItemDefaults

          public DrawItem getDrawItemDefaults()

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Returns:
        DrawItem

    - #### setDrawItemLiveObject

          public void setDrawItemLiveObject(DrawItem liveObject)

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Parameters:
        `liveObject` - Default value is null

    - #### getDrawItemLiveObject

          public DrawItem getDrawItemLiveObject()

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Returns:
        DrawItem

    - #### setFormItemDefaults

          public void setFormItemDefaults(FormItem defaults)

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Parameters:
        `defaults` - Default value is null

    - #### getFormItemDefaults

          public FormItem getFormItemDefaults()

      Defaults for the component to be created from this palette.

      For example, if `type` is "ListGrid", properties valid to pass to ListGrid.create().

      Returns:
        FormItem

    - #### setFormItemLiveObject

          public void setFormItemLiveObject(FormItem liveObject)

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Parameters:
        `liveObject` - Default value is null

    - #### getFormItemLiveObject

          public FormItem getFormItemLiveObject()

      For a paletteNode which should be a "singleton", that is, always provides the exact same object (==) rather than a dynamically created copy, provide the singleton object as `liveObject`.

      Instead of dynamically creating an object from defaults, the `liveObject` will simply be assigned to `liveObject` for the created editNode.

      Returns:
        FormItem

    - #### setIcon

          public void setIcon(java.lang.String icon)

      Icon for this paletteNode.
      Parameters:
        `icon` - See `SCImgURL` . Default value is null

    - #### getIcon

          public java.lang.String getIcon()

      Icon for this paletteNode.
      Returns:
        See `SCImgURL`

    - #### setTitle

          public void setTitle(java.lang.String title)

      Textual title for this paletteNode.
      Parameters:
        `title` - Default value is null

    - #### getTitle

          public java.lang.String getTitle()

      Textual title for this paletteNode.
      Returns:
        String

    - #### setType

          public void setType(java.lang.String type)

      String this paletteNode creates, for example, "ListGrid".
      Parameters:
        `type` - See `SCClassName` . Default value is null

    - #### getType

          public java.lang.String getType()

      String this paletteNode creates, for example, "ListGrid".
      Returns:
        See `SCClassName`