配置 Visio 时间线形状

设置里程碑形状属性

Aspose.Diagram 允许开发人员设置里程碑属性。本文介绍如何设置里程碑日期、日期格式、自动更新标志和类型。

设置里程碑日期、日期格式、自动更新标志和类型

这里程碑助手上课需要一个形状初始化时的对象里程碑助手目的。本文中的代码示例设置里程碑日期、日期格式、自动更新标志和里程碑类型属性。

更新前的里程碑 </p>	更新后的里程碑。请注意更改后的日期格式。 </p>
更新里程碑日期、日期格式、自动更新标志和里程碑类型的过程：

1. 加载一个 diagram。
2. 找到一个特定的形状。
3. 初始化 MilestoneHelper 对象。
4. 设置里程碑日期。
5. 设置里程碑日期格式。
6. 设置自动更新标志。
7. 设置里程碑类型
8. 将 Visio 图形保存为任何支持的格式。

设置里程碑编程示例

// For complete examples and data files, please go to https://github.com/aspose-diagram/Aspose.Diagram-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(SetMilestoneProps.class);  
// Load diagram
Diagram diagram = new Diagram(dataDir + "DrawingTimeLine.vsdx");
int shapeid = 22;
// Get timeline shape
Shape milestone = diagram.getPages().getPage("Page-1").getShapes().getShape(shapeid);

// Initialize MilestoneHelper object
MilestoneHelper milestoneHelper = new MilestoneHelper(milestone);

// Set milestone date
milestoneHelper.setMilestoneDate(new DateTime(2014, 10, 21));
// Set date format
milestoneHelper.setDateFormat(21);
// Set auto update flag
milestoneHelper.setAutoUpdate(true);
// Set milestone type
milestoneHelper.setType(6);

// Save to VDX format
diagram.save(dataDir + "SetMilestoneProps_Out.vsdx", SaveFileFormat.VSDX);

日期格式值表：

价值	格式化字符串
0	dddd, yyyy-Md
1	yyyy-MM-dd
2	yy-MMM-d
3	年/月/日
4	yy-MMM.-d
5	d MMMM yyyy
6	yy-M
7	MMM-yy
8	MMMM d, yyyy
9	MMM d, yyyy
10	MD-YY
11	MD
12	d MMMM, yyyy
13	d 嗯，yyyy
14	dM-yy
15	分米
16	yy-Md
17	yyyy-MD
18	M-yy
19	M-yyyy
20	MMMM yyyy
21	嗯嗯
22	嗯嗯嗯
23	嗯嗯
24	yy
25	yyyy
26	d
27	嗯嗯
28	嗯
29	米

设置时间线形状的时间段和日期格式

Aspose.Diagram 允许开发人员以编程方式配置时间线。这解释了如何调整时间线形状（块、线、标尺、分割或圆柱形）的时间段和日期格式。

设置时间段和日期格式

这时间线助手上课需要一个形状初始化时的对象时间线助手目的。本文中的代码示例设置时间段开始、结束和日期格式值。

Visio 配置时间轴对话框的时间段选项卡	Visio 配置时间轴对话框的时间格式选项卡
输入 diagram	值更改后的 diagram
更新时间段开始、结束和日期格式的过程是：

1. 加载一个 diagram。
2. 找到一个特定的形状。
3. 初始化 TimeLineHelper 对象。
4. 设置时间段开始。
5. 设置时间段结束。
6. 设置日期格式。
7. 将 Visio 图形保存为任何支持的格式。

设置时间段和日期编程示例

// For complete examples and data files, please go to https://github.com/aspose-diagram/Aspose.Diagram-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ConfigureTimeLine.class); 
// Load diagram
Diagram diagram = new Diagram(dataDir + "DrawingTimeLine.vsdx");
int shapeid = 1;
// Get timeline shape
Shape timeline = diagram.getPages().getPage("Page-1").getShapes().getShape(shapeid);

// Initialize TimeLineHlper object
TimeLineHelper timelineHelper = new TimeLineHelper(timeline);

// Set start time
timelineHelper.setTimePeriodStart(new DateTime(2014, 12, 21));
// Set end time
timelineHelper.setTimePeriodFinish(new DateTime(2015, 2, 19));

// Set date format
//timelineHelper.setDateFormatForBE(21);
// Set date format for intm of timeline shape   
//timelineHelper.setDateFormatForIntm(21);

// Or

// Set date format string for start and finish of timeline shape
timelineHelper.setDateFormatStringForBE("yyyy-MM-dd");
// Set date format string for intm of timeline shape
timelineHelper.setDateFormatStringForIntm("yyyy-MM-dd");

// Save to VDX format
diagram.save(dataDir + "ConfigureTimeLine_Out.vsdx", SaveFileFormat.VSDX);

日期格式值表：

价值	格式化字符串
0	dddd, yyyy-Md
1	yyyy-MM-dd
2	yy-MMM-d
3	年/月/日
4	yy-MMM.-d
5	d MMMM yyyy
6	yy-M
7	MMM-yy
8	MMMM d, yyyy
9	MMM d, yyyy
10	MD-YY
11	MD
12	d MMMM, yyyy
13	d 嗯，yyyy
14	dM-yy
15	分米
16	yy-Md
17	yyyy-MD
18	M-yy
19	M-yyyy
20	MMMM yyyy
21	嗯嗯
22	嗯嗯嗯
23	嗯嗯
24	yy
25	yyyy
26	d
27	嗯嗯
28	嗯
29	米

刷新时间轴上的里程碑 Visio

Aspose.Diagram 允许开发人员根据时间段变化调整时间轴形状（块、线、标尺、分割或圆柱形）上的里程碑。

使用 TimeLineHelper 类刷新时间轴上的里程碑

公开的 RefreshTimeLine 方法时间线助手类可用于恢复时间轴上的里程碑。

下面的代码显示了如何：

1. 加载样本 diagram。
2. 得到一个时间线形状。
3. 初始化 TimeLineHelper 对象。
4. 设置时间段开始。
5. 设置时间段结束。
6. 设置日期格式（可选）。
7. 调用 TimeLineHelper 对象的 RefreshTimeLine 方法。
8. 保存 diagram

使用 TimeLineHelper 编程示例刷新里程碑

在您的 Java 应用程序中使用以下代码，使用 Aspose.Diagram for Java 恢复时间轴上的里程碑。

// For complete examples and data files, please go to https://github.com/aspose-diagram/Aspose.Diagram-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(RefreshTimeLine.class);   
// Load diagram
Diagram diagram = new Diagram(dataDir + "DrawingTimeLine.vsdx");

int shapeid = 1;
// Get timeline shape
Shape timeline = diagram.getPages().getPage("Page-1").getShapes().getShape(shapeid);

// Initialize TimeLineHlper object
TimeLineHelper timelineHelper = new TimeLineHelper(timeline);

// Set start time
timelineHelper.setTimePeriodStart(new DateTime(2014, 12, 21));
// Set end time
timelineHelper.setTimePeriodFinish(new DateTime(2015, 2, 19));

// Set date format
timelineHelper.setDateFormatForBE(21);

//revive milestones on the timeline
timelineHelper.refreshTimeLine();

// Save to VDX format
diagram.save(dataDir + "RefreshTimeLine_Out.vsdx", SaveFileFormat.VSDX);

使用 MilestoneHelper 类刷新时间轴上的里程碑

公开的 RefreshMilestone 方法里程碑助手类可用于刷新时间轴上的里程碑。

下面的代码显示了如何：

1. 加载样本 diagram。
2. 得到一个时间线形状。
3. 使用 AddShape 方法在 Visio diagram 添加 Shape。
4. 初始化 MilestoneHelper 对象。
5. 设置里程碑日期。
6. 将 Milstone 的 IsAutoUpdate 属性设置为 true。
7. 调用 MilestoneHelper 对象的 RefreshMilestone 方法。
8. 保存 diagram

使用 MilestoneHelper 编程示例刷新里程碑

在您的 Java 应用程序中使用以下代码，使用 Aspose.Diagram for Java 刷新时间轴上的里程碑。

// For complete examples and data files, please go to https://github.com/aspose-diagram/Aspose.Diagram-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(RefreshMilestoneWithMilestoneHelper.class);
        
String pageName = "Page-1";

////////////// Modify time line /////////// 
DateTime startDate = new DateTime(2015, 8, 1);
DateTime endDate = new DateTime(2016, 6, 1);
DateTime fisYear = startDate;

//Load a diagram 
Diagram diagram = new Diagram(dataDir + "DrawingTimeLine.vsdx");

//Get page
Page page = diagram.getPages().getPage(pageName);

long timelineId = 1;
Shape timeline = diagram.getPages().getPage(pageName).getShapes().getShape(timelineId);
double xpos = timeline.getXForm().getPinX().getValue();
double ypos = timeline.getXForm().getPinY().getValue();

// Add milestone 
String milestoneMasterName = "2 triangle milestone";

//Add Master
diagram.addMaster(dataDir + "Timeline.vss", milestoneMasterName);

//Add Shape in Visio diagram using AddShape method
long milestoneShapeId = diagram.addShape(xpos, ypos, milestoneMasterName, 0);

//Get the shape based on ID
Shape milestone = page.getShapes().getShape(milestoneShapeId);

//Instantiate MilestoneHelper object
MilestoneHelper milestoneHelper = new MilestoneHelper(milestone);

//Set Milestone Date
milestoneHelper.setMilestoneDate(new DateTime(2015, 8, 1));

//Set IsAutoUpdate to true
milestoneHelper.setAutoUpdate(true);

//RefreshMilesone of timeline shape
milestoneHelper.refreshMilestone(timeline);

//Save Visio file
diagram.save(dataDir + "RefreshMilestone_Out.vsdx", SaveFileFormat.VSDX);