docstr: Construct a new Newselection object
  
  Parameters
  ----------
  arg
      dict of properties compatible with this constructor or
      an instance of
      :class:`plotly.graph_objs.layout.Newselection`
  line
      :class:`plotly.graph_objects.layout.newselection.Line`
      instance or dict with compatible properties
  mode
      Describes how a new selection is created. If
      `immediate`, a new selection is created after first
      mouse up. If `gradual`, a new selection is not created
      after first mouse. By adding to and subtracting from
      the initial selection, this option allows declaring
      extra outlines of the selection.
  
  Returns
  -------
  Newselection
docstr_tok: ["Construct","a","new","Newselection","object","Parameters","--","--","--","--","--","arg","dict","of","properties","compatible","with","this","constructor","or","an","instance","of",":","class",":","`","plotly.graph_objs.layout.Newselection","`","line",":","class",":","`","plotly.graph_objects.layout.newselection.Line","`","instance","or","dict","with","compatible","properties","mode","Describes","how","a","new","selection","is","created",".","If","`","immediate","`",",","a","new","selection","is","created","after","first","mouse","up",".","If","`","gradual","`",",","a","new","selection","is","not","created","after","first","mouse",".","By","adding","to","and","subtracting","from","the","initial","selection",",","this","option","allows","declaring","extra","outlines","of","the","selection",".","Returns","--","--","--","-","Newselection"]
code: def __init__(self, arg=None, line=None, mode=None, **kwargs):
      """
      Construct a new Newselection object
  
      Parameters
      ----------
      arg
          dict of properties compatible with this constructor or
          an instance of
          :class:`plotly.graph_objs.layout.Newselection`
      line
          :class:`plotly.graph_objects.layout.newselection.Line`
          instance or dict with compatible properties
      mode
          Describes how a new selection is created. If
          `immediate`, a new selection is created after first
          mouse up. If `gradual`, a new selection is not created
          after first mouse. By adding to and subtracting from
          the initial selection, this option allows declaring
          extra outlines of the selection.
  
      Returns
      -------
      Newselection
      """
      super(Newselection, self).__init__("newselection")
  
      if "_parent" in kwargs:
          self._parent = kwargs["_parent"]
          return
  
      # Validate arg
      # ------------
      if arg is None:
          arg = {}
      elif isinstance(arg, self.__class__):
          arg = arg.to_plotly_json()
      elif isinstance(arg, dict):
          arg = _copy.copy(arg)
      else:
          raise ValueError(
              """\
  The first argument to the plotly.graph_objs.layout.Newselection
  constructor must be a dict or
  an instance of :class:`plotly.graph_objs.layout.Newselection`"""
          )
  
      # Handle skip_invalid
      # -------------------
      self._skip_invalid = kwargs.pop("skip_invalid", False)
      self._validate = kwargs.pop("_validate", True)
  
      # Populate data dict with properties
      # ----------------------------------
      _v = arg.pop("line", None)
      _v = line if line is not None else _v
      if _v is not None:
          self["line"] = _v
      _v = arg.pop("mode", None)
      _v = mode if mode is not None else _v
      if _v is not None:
          self["mode"] = _v
  
      # Process unknown kwargs
      # ----------------------
      self._process_kwargs(**dict(arg, **kwargs))
  
      # Reset skip_invalid
      # ------------------
      self._skip_invalid = False
  
file_path: plotly.py/packages/python/plotly/plotly/graph_objs/layout/_newselection.py
imports: from plotly.basedatatypes import BaseLayoutHierarchyType
  import copy
label_desc: Use image node_id 6 to create a new Newselection object from inherited base classes: _BaseLayoutHierarchyType with example: obj = Newselection(arg, line, mode)