Merge pull request #19 from aspose-cells/main

API references of Aspose.Cells 25.7 releases: .Net, Java, Cpp, Nodejs via C++, Go via C++.

Author: peytonxuaspose

english/cpp/aspose.cells.drawing/shapecollection/addfreeform/_index.md

@@ -20,18 +20,22 @@ Shape Aspose::Cells::Drawing::ShapeCollection::AddFreeform(int32_t upperLeftRow,
 | Parameter | Type | Description |
 | --- | --- | --- |
 | upperLeftRow | int32_t | Upper left row index. |
-| top | int32_t | Represents the vertical offset of Polygon from its left row, in unit of pixel. |
+| top | int32_t | Represents the vertical offset of freeform shape from its left row, in unit of pixel. |
 | upperLeftColumn | int32_t | Upper left column index. |
-| left | int32_t | Represents the horizontal offset of Polygon from its left column, in unit of pixel. |
-| height | int32_t | Represents the height of Polygon, in unit of pixel. |
-| width | int32_t | Represents the width of Polygon, in unit of pixel. |
+| left | int32_t | Represents the horizontal offset of freeform shape from its left column, in unit of pixel. |
+| height | int32_t | Represents the height of freeform shape, in unit of pixel. |
+| width | int32_t | Represents the width of freeform shape, in unit of pixel. |
 | paths | const Vector \<ShapePath\>\& | Represents a user-defined path |
 
 ## ReturnValue
 
 A freeform shape.
+## Remarks
 
 
+
+Notice: That the width and height in the parameters can be any positive integer values, not the total width and height of the [ShapePath](../../shapepath/) array specified by ’paths'. The relationship between them is a scale-fill relationship, that is, each [ShapePath](../../shapepath/) object will be scaled according to the width and height. Therefore, when there are multiple objects in the 'paths', each [ShapePath](../../shapepath/) object needs to be designed reasonably to meet expectations. When there is only one [ShapePath](../../shapepath/) object and there are no other requirements, passing the object's width and height as parameter values ​​is a good solution.
+
 ## Examples
 
 
@@ -51,6 +55,9 @@ shapePath.Close();
 shapePath.MoveTo(150, 45);
 shapePath.ArcTo(25, 25, 0, 270);
 
+int shapePathW = shapePath.GetWidthPixel();
+int shapePathH = shapePath.GetHeightPixel();
+
 ShapePath shapePath1;
 shapePath1.MoveTo(0, 0);
 shapePath1.CubicBezierTo(48.24997f, 0.6844f,
@@ -62,8 +69,20 @@ shapePath1.CubicBezierTo(163.5f, 30.18446f,
 shapePath1.MoveTo(150, 80);
 shapePath1.ArcTo(25, 25, 0, 270);
 
+if (shapePath1.GetWidthPixel() > shapePathW)
+{
+    shapePathW = shapePath1.GetWidthPixel();
+}
+
+if (shapePath1.GetHeightPixel() > shapePathH)
+{
+    shapePathH = shapePath1.GetHeightPixel();
+}
+
+//Notice: shapePathH and shapePathH can be any positive integer values, here we just simply set them.
+
 //Insert custom figure into worksheet
-shapes.AddFreeform(1, 0, 1, 0, 200, 200, Vector<ShapePath>{ shapePath, shapePath1 });
+shapes.AddFreeform(1, 0, 1, 0, shapePathH, shapePathW, Vector<ShapePath>{ shapePath, shapePath1 });
 ```
 
 ## See Also

english/cpp/aspose.cells.drawing/shapepath/_impl/_index.md

@@ -4,7 +4,7 @@ linktitle: _impl
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::_impl field. The implementation object in C++.'
 type: docs
-weight: 1200
+weight: 1600
 url: /cpp/aspose.cells.drawing/shapepath/_impl/
 ---
 ## _impl field

english/cpp/aspose.cells.drawing/shapepath/_index.md

@@ -23,12 +23,16 @@ class ShapePath
 | [ArcTo(float wR, float hR, float stAng, float swAng)](./arcto/) | Appends an elliptical arc to the current figure. The starting point is the end point of the current figure. |
 | [Close()](./close/) | Closes the current figure and starts a new figure. If the current figure contains a sequence of connected lines and curves, the method closes the loop by connecting a line from the endpoint to the starting point. |
 | [CubicBezierTo(float ctrX1, float ctrY1, float ctrX2, float ctrY2, float endX, float endY)](./cubicbezierto/) | Appends a cubic Bézier curve to the current figure. The starting point is the end point of the current figure. |
+| [GetHeightPixel()](./getheightpixel/) | Gets the height of this path in unit of pixels. |
 | [GetPathSegementList()](./getpathsegementlist/) | Gets [ShapeSegmentPathCollection](../shapesegmentpathcollection/) list. |
+| [GetWidthPixel()](./getwidthpixel/) | Gets the width of this path in unit of pixels. |
 | [IsNull()](./isnull/) const | Checks whether the implementation object is nullptr. |
 | [LineTo(float x, float y)](./lineto/) | Appends a line segment to the current figure. The starting point is the end point of the current figure. |
 | [MoveTo(float x, float y)](./moveto/) | Starts a new figure from the specified point without closing the current figure. All subsequent points added to the path are added to this new figure. |
 | explicit [operator bool()](./operator_bool/) const | operator bool() |
 | [operator=(const ShapePath\& src)](./operator_asm/) | operator= |
+| [SetHeightPixel(int32_t value)](./setheightpixel/) | Gets the height of this path in unit of pixels. |
+| [SetWidthPixel(int32_t value)](./setwidthpixel/) | Gets the width of this path in unit of pixels. |
 | [ShapePath()](./shapepath/) | Initializes a new instance of the [ShapePath](./) class. |
 | [ShapePath(ShapePath_Impl* impl)](./shapepath/) | Constructs from an implementation object. |
 | [ShapePath(const ShapePath\& src)](./shapepath/) | Copy constructor. |

english/cpp/aspose.cells.drawing/shapepath/arcto/_index.md

@@ -4,7 +4,7 @@ linktitle: ArcTo
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::ArcTo method. Appends an elliptical arc to the current figure. The starting point is the end point of the current figure in C++.'
 type: docs
-weight: 1000
+weight: 1400
 url: /cpp/aspose.cells.drawing/shapepath/arcto/
 ---
 ## ShapePath::ArcTo method
@@ -19,10 +19,10 @@ void Aspose::Cells::Drawing::ShapePath::ArcTo(float wR, float hR, float stAng, f
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| wR | float | The half-width of the rectangular area of ​​the ellipse that draws the arc. |
-| hR | float | The half-height of the rectangular area of ​​the ellipse that draws the arc. |
-| stAng | float | The starting angle of the arc, measured in degrees clockwise from the x-axis. |
-| swAng | float | The angle between startAngle and the end of the arc. |
+| wR | float | The half-width of the rectangular area of ​​the ellipse that draws the arc(Unit: Pixel). |
+| hR | float | The half-height of the rectangular area of ​​the ellipse that draws the arc(Unit: Pixel). |
+| stAng | float | The starting angle of the arc, measured in degrees clockwise from the x-axis(Unit: Degree). |
+| swAng | float | The angle between startAngle and the end of the arc.(Unit: Degree) |
 
 ## See Also
 

english/cpp/aspose.cells.drawing/shapepath/close/_index.md

@@ -4,7 +4,7 @@ linktitle: Close
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::Close method. Closes the current figure and starts a new figure. If the current figure contains a sequence of connected lines and curves, the method closes the loop by connecting a line from the endpoint to the starting point in C++.'
 type: docs
-weight: 1100
+weight: 1500
 url: /cpp/aspose.cells.drawing/shapepath/close/
 ---
 ## ShapePath::Close method

english/cpp/aspose.cells.drawing/shapepath/cubicbezierto/_index.md

@@ -4,7 +4,7 @@ linktitle: CubicBezierTo
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::CubicBezierTo method. Appends a cubic Bézier curve to the current figure. The starting point is the end point of the current figure in C++.'
 type: docs
-weight: 900
+weight: 1300
 url: /cpp/aspose.cells.drawing/shapepath/cubicbezierto/
 ---
 ## ShapePath::CubicBezierTo method
@@ -19,12 +19,12 @@ void Aspose::Cells::Drawing::ShapePath::CubicBezierTo(float ctrX1, float ctrY1,
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| ctrX1 | float | The x-coordinate of the first control point for the curve. |
-| ctrY1 | float | The y-coordinate of the first control point for the curve. |
-| ctrX2 | float | The x-coordinate of the second control point for the curve. |
-| ctrY2 | float | The y-coordinate of the second control point for the curve. |
-| endX | float | The x-coordinate of the endpoint of the curve. |
-| endY | float | The y-coordinate of the endpoint of the curve. |
+| ctrX1 | float | The x-coordinate of the first control point for the curve(Unit: Pixel). |
+| ctrY1 | float | The y-coordinate of the first control point for the curve(Unit: Pixel). |
+| ctrX2 | float | The x-coordinate of the second control point for the curve(Unit: Pixel). |
+| ctrY2 | float | The y-coordinate of the second control point for the curve(Unit: Pixel). |
+| endX | float | The x-coordinate of the endpoint of the curve(Unit: Pixel). |
+| endY | float | The y-coordinate of the endpoint of the curve(Unit: Pixel). |
 
 ## See Also
 

english/cpp/aspose.cells.drawing/shapepath/getheightpixel/_index.md

@@ -0,0 +1,24 @@
+---
+title: Aspose::Cells::Drawing::ShapePath::GetHeightPixel method
+linktitle: GetHeightPixel
+second_title: Aspose.Cells for C++ API Reference
+description: 'Aspose::Cells::Drawing::ShapePath::GetHeightPixel method. Gets the height of this path in unit of pixels in C++.'
+type: docs
+weight: 900
+url: /cpp/aspose.cells.drawing/shapepath/getheightpixel/
+---
+## ShapePath::GetHeightPixel method
+
+
+Gets the height of this path in unit of pixels.
+
+```cpp
+int32_t Aspose::Cells::Drawing::ShapePath::GetHeightPixel()
+```
+
+## See Also
+
+* Class [Vector](../../../aspose.cells/vector/)
+* Class [ShapePath](../)
+* Namespace [Aspose::Cells::Drawing](../../)
+* Library [Aspose.Cells for C++](../../../)

english/cpp/aspose.cells.drawing/shapepath/getwidthpixel/_index.md

@@ -0,0 +1,24 @@
+---
+title: Aspose::Cells::Drawing::ShapePath::GetWidthPixel method
+linktitle: GetWidthPixel
+second_title: Aspose.Cells for C++ API Reference
+description: 'Aspose::Cells::Drawing::ShapePath::GetWidthPixel method. Gets the width of this path in unit of pixels in C++.'
+type: docs
+weight: 700
+url: /cpp/aspose.cells.drawing/shapepath/getwidthpixel/
+---
+## ShapePath::GetWidthPixel method
+
+
+Gets the width of this path in unit of pixels.
+
+```cpp
+int32_t Aspose::Cells::Drawing::ShapePath::GetWidthPixel()
+```
+
+## See Also
+
+* Class [Vector](../../../aspose.cells/vector/)
+* Class [ShapePath](../)
+* Namespace [Aspose::Cells::Drawing](../../)
+* Library [Aspose.Cells for C++](../../../)

english/cpp/aspose.cells.drawing/shapepath/lineto/_index.md

@@ -4,7 +4,7 @@ linktitle: LineTo
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::LineTo method. Appends a line segment to the current figure. The starting point is the end point of the current figure in C++.'
 type: docs
-weight: 800
+weight: 1200
 url: /cpp/aspose.cells.drawing/shapepath/lineto/
 ---
 ## ShapePath::LineTo method
@@ -19,8 +19,8 @@ void Aspose::Cells::Drawing::ShapePath::LineTo(float x, float y)
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| x | float | The x-coordinate of the endpoint of the line segment. |
-| y | float | The y-coordinate of the endpoint of the line segment. |
+| x | float | The x-coordinate of the endpoint of the line segment(Unit: Pixel). |
+| y | float | The y-coordinate of the endpoint of the line segment(Unit: Pixel). |
 
 ## See Also
 

english/cpp/aspose.cells.drawing/shapepath/moveto/_index.md

@@ -4,7 +4,7 @@ linktitle: MoveTo
 second_title: Aspose.Cells for C++ API Reference
 description: 'Aspose::Cells::Drawing::ShapePath::MoveTo method. Starts a new figure from the specified point without closing the current figure. All subsequent points added to the path are added to this new figure in C++.'
 type: docs
-weight: 700
+weight: 1100
 url: /cpp/aspose.cells.drawing/shapepath/moveto/
 ---
 ## ShapePath::MoveTo method
@@ -19,8 +19,8 @@ void Aspose::Cells::Drawing::ShapePath::MoveTo(float x, float y)
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| x | float | The x-coordinate of the starting point of the figure. |
-| y | float | The y-coordinate of the starting point of the figure. |
+| x | float | The x-coordinate of the starting point of the figure(Unit: Pixel). |
+| y | float | The y-coordinate of the starting point of the figure(Unit: Pixel). |
 
 ## See Also