[]
        
(Showing Draft Content)

调整形状

除了在GcExcel中更改形状的大小外,您还可以更改形状的几何形状并修改其外观。这可以通过设置形状的调整值来实现,例如自选图形或连接器。它使您可以更好地控制形状,以创建有效的流程图,仪表板和报告。


GcExcel提供了Adjustments的方法中IShape的接口获取调整值的集合为指定自选图形或连接器。


不同调节类型的调节值的有效范围如下所述:


调整类型

有效值

线性(水平或垂直)

值0.0表示形状的左边缘或上边缘。

值1.0表示形状的右边缘或底边缘。

对于诸如连接器和标注的形状,值0.0和1.0对应于由连接器或标注线的起点和终点定义的矩形。

小于0.0且大于1.0的值也有效。

调整的有效值对应于可以通过扩展调整点在Excel中对形状进行的有效调整。

例如,如果只能在Excel中将调整点拉到形状的一半,则相应调整的最大值将为0.5。

径向的

值1.0表示形状宽度。因此,径向调整的最大值是0.5,是形状的一半。

角度

以度表示。如果您指定的值超出180度范围,则将其标准化为该范围内。

在大多数情况下,如果值超出有效范围,则将其标准化为最接近的有效值。

用例代码

请参考以下示例代码,以在Excel中调整形状的尺寸:

private static void AdjustmentPointForShape() {
    // Initialize workbook
    Workbook workbook = new Workbook();
    // Fetch default worksheet
    IWorksheet worksheet = workbook.getWorksheets().get(0);
    // Add a right arrow callout
    IShape shape = worksheet.getShapes().addShape(AutoShapeType.RightArrowCallout, 20, 20, 200, 100);

    // Set adjustment points for shapes
    IAdjustments adjustments = shape.getAdjustments();

    // To count adjustment points
    int c = adjustments.getCount();
    System.out.println("Count of Adjustment Values: " + c);

    adjustments.set(0, 0.5);// arrow neck width
    adjustments.set(1, 0.4);// arrow head width
    adjustments.set(2, 0.5);// arrow head height
    adjustments.set(3, 0.6);// text box width

    // Saving workbook to Xlsx
    workbook.save("17-AdjustmentPointForShape.xlsx", SaveFileFormat.Xlsx);