+.. |distance_v.icon| image:: images/distance_v.png
Vertical distance constraint
============================
To create a Vertical Distance constraint in the active Sketch:
#. select in the Main Menu *Sketch - > Vertical Distance* item or
-#. click **Vertical Distance** button in Sketch toolbar:
-
-.. image:: images/distance_v.png
- :align: center
-
-.. centered::
- **Vertical Distance** button
+#. click |distance_v.icon| **Vertical Distance** button in Sketch toolbar:
Property panel:
-.. image:: images/VerticalDistance_panel.png
+.. figure:: images/VerticalDistance_panel.png
:align: center
+.. |location_left| image:: images/location_left.png
+.. |location_auto| image:: images/location_automatic.png
+.. |location_right| image:: images/location_right.png
+
Input fields:
- **First point** is the first point selected in the view;
- **Second point** is the second point selected in the view:
- **Value** is a distance between the objects, can be modified to set the desirable value;
- **Text location** is a position of the distance value label relating to extension line (in the view):
- .. image:: images/location_left.png
- :align: left
- **Left** inserts text to the left of the distance extension line:
-
- .. image:: images/location_automatic.png
- :align: left
- **Automatic** inserts text in the middle of the distance extension line if it has enough length, otherwise - to the left
-
- .. image:: images/location_right.png
- :align: left
- **Right** inserts text to the right of the distance extension line.
+ | |location_left| **Left** inserts text to the left of the distance extension line:
+ | |location_auto| **Automatic** inserts text in the middle of the distance extension line if it has enough length, otherwise - to the left
+ | |location_right| **Right** inserts text to the right of the distance extension line.
When both objects are selected, the vertical distance value is displayed in the property panel and in the view.
- drag the Vertical distance presentation in the view to the desired position and click once;
- set desirable vertical distance value in the input field in the view and press **Enter** or just press **Enter** to keep the current distance.
-.. image:: images/VerticalDistance_field_view.png
+.. figure:: images/VerticalDistance_field_view.png
:align: center
-.. centered::
Vertical Distance input in the view
-**TUI Command**: *Sketch_1.setVerticalDistance(FirstObject, SecondObject, Value)*
+**TUI Command**:
-**Arguments**: 2 objects + vertical distance value
+.. py:function:: Sketch_1.setVerticalDistance(FirstObject, SecondObject, Value)
+
+ :param object: First object.
+ :param object: Second object.
+ :param real: Value.
+ :return: Result object.
Result
""""""
Created Vertical Distance appears in the view.
-.. image:: images/VerticalDistance_res.png
- :align: center
+.. figure:: images/VerticalDistance_res.png
+ :align: center
-.. centered::
Vertical Distance created
**See Also** a sample TUI Script of :ref:`tui_create_vdistance` operation.