src/FeaturesPlugin/doc/importResultFeature.rst

   1 .. |import_result_btn.icon|    image:: images/import_result_btn.png
   2
   3 Import Result
   4 =============
   5
   6 The Import Result feature allows the user to import one or several results from another Part. If the result of the source-part is
   7 changed, the part and part result that contains the copy-results will be updated. The feature keeps the
   8 copy-shape, so, even the document was opened and the source-part was not activated (loaded), the part with copy-feature works well
   9 with this result-shape.
  10
  11 It may be necessary for the user to load the other parts before using this feature otherwise the content of the **Results** folders will be empty.
  12
  13 To create a Copy in the active part:
  14
  15 #. select in the Main Menu *Features - > Import Result* item  or
  16 #. click |import_result_btn.icon| **Import Result** button in the toolbar
  17
  18
  19 The following property panel will be opened:
  20
  21 .. figure:: images/ImportResult.png
  22    :align: center
  23
  24    **Import result operation**
  25
  26 Here it is necessary to select one or several objects. It is only possible to import results from Parts placed before the
  27 current Part where the import is done. Only results from the **Results** folder of previously created parts may be selected.
  28
  29
  30 **Apply** button creates a copy.
  31
  32 **Cancel** button cancels the operation.
  33
  34 **TUI Command**:
  35
  36 .. py:function:: model.addImportResult(Part_doc, results)
  37
  38     :param part: The current part object.
  39     :param results: A list of results from another part.
  40     :return: Result feature Import Result.
  41
  42 Result
  43 """"""
  44
  45 The Result of the operation will be copy of one or several results selected in another part located in the same place:
  46
  47 .. figure:: images/CreatedImportResult.png
  48    :align: center
  49
  50    **Import result created**
  51
  52 **See Also** a sample TUI Script of :ref:`tui_create_import_result` operation.