Merge pull request #106 from aspose-tasks/main

Updated to Aspose.Tasks for .NET 25.5.

Author: sva1000

english/net/aspose.tasks.saving/primaverasaveoptions/skipsummaryassignments/_index.md

@@ -18,6 +18,27 @@ public bool SkipSummaryAssignments { get; set; }
 
 Primavera software doesn't support assignments of resources to summary (WBS) tasks. Thus, export of such assignments can result in an invalid file according to Primavera's model. If true, assignments to summary tasks are skipped during export. If false (the default value), an exception will be thrown if assignment to a summary task is encountered during export.
 
+## Examples
+
+Shows how to use SkipSummaryAssignments flag.
+
+```csharp
+var project = new Project(DataDir + "Blank2010.mpp");
+
+var resource = project.Resources.Add("Resource");
+
+var summaryTask = project.RootTask.Children.Add("Summary");
+summaryTask.Children.Add("Task");
+
+// Primavera doesn't support assignments of resources to summary tasks.
+// So exporting such assignments to Primavera format may result in files that cannot be imported to Primavera.
+var assignment = project.ResourceAssignments.Add(summaryTask, resource);
+
+var options = new PrimaveraXmlSaveOptions();
+options.SkipSummaryAssignments = true;
+project.Save(OutDir + "UseSkipSummaryAssignments_out.xml", options);
+```
+
 ### See Also
 
 * class [PrimaveraSaveOptions](../)

english/net/aspose.tasks.saving/primaveraxmlsaveoptions/skipsummaryassignments/_index.md

@@ -18,6 +18,27 @@ public bool SkipSummaryAssignments { get; set; }
 
 Primavera software doesn't support assignments of resources to summary (WBS) tasks. Thus, export of such assignments can result in an invalid file according to Primavera's model. If true, assignments to summary tasks are skipped during export. If false (the default value), an exception will be thrown if assignment to a summary task is encountered during export.
 
+## Examples
+
+Shows how to use SkipSummaryAssignments flag.
+
+```csharp
+var project = new Project(DataDir + "Blank2010.mpp");
+
+var resource = project.Resources.Add("Resource");
+
+var summaryTask = project.RootTask.Children.Add("Summary");
+summaryTask.Children.Add("Task");
+
+// Primavera doesn't support assignments of resources to summary tasks.
+// So exporting such assignments to Primavera format may result in files that cannot be imported to Primavera.
+var assignment = project.ResourceAssignments.Add(summaryTask, resource);
+
+var options = new PrimaveraXmlSaveOptions();
+options.SkipSummaryAssignments = true;
+project.Save(OutDir + "UseSkipSummaryAssignments_out.xml", options);
+```
+
 ### See Also
 
 * class [PrimaveraXmlSaveOptions](../)

english/net/aspose.tasks.saving/saveoptions/legenddrawingoptions/_index.md

@@ -65,6 +65,30 @@ SaveOptions options = new PdfSaveOptions
 project.Save(OutDir + "Legend_DefinedInView.pdf", options);
 ```
 
+Shows how to customize task bars in page legend of Gantt chart.
+
+```csharp
+var project = new Project(DataDir + "Blank2010.mpp");
+
+var pdfSaveOptions = new PdfSaveOptions();
+pdfSaveOptions.StartDate = project.StartDate;
+pdfSaveOptions.EndDate = project.FinishDate;
+pdfSaveOptions.PageSize = PageSize.A4;
+pdfSaveOptions.LegendDrawingOptions = LegendDrawingOptions.OnEveryPage;
+pdfSaveOptions.ViewSettings = project.Views.GetByName("&Gantt Chart");
+
+pdfSaveOptions.LegendItems = new PageLegendItem[]
+{
+    new PageLegendItem(BarItemType.Task, "Task"),
+    new PageLegendItem(BarItemType.ExternalMilestone, "External Milestone"),
+    new PageLegendItem(BarItemType.SummaryRollup, "Summary Rollup"),
+    new PageLegendItem(BarItemType.InactiveTask, "Inactive Task"),
+    new PageLegendItem(BarItemType.ManualSummary, "Manual Summary")
+};
+
+project.Save(OutDir + "CustomizePageLegendItems_out.pdf", pdfSaveOptions);
+```
+
 ### See Also
 
 * enum [LegendDrawingOptions](../../legenddrawingoptions/)

english/net/aspose.tasks.saving/saveoptions/legenditems/_index.md

@@ -18,6 +18,32 @@ public PageLegendItem[] LegendItems { get; set; }
 
 Is only applicable when Gantt chart view is rendered.
 
+## Examples
+
+Shows how to customize task bars in page legend of Gantt chart.
+
+```csharp
+var project = new Project(DataDir + "Blank2010.mpp");
+
+var pdfSaveOptions = new PdfSaveOptions();
+pdfSaveOptions.StartDate = project.StartDate;
+pdfSaveOptions.EndDate = project.FinishDate;
+pdfSaveOptions.PageSize = PageSize.A4;
+pdfSaveOptions.LegendDrawingOptions = LegendDrawingOptions.OnEveryPage;
+pdfSaveOptions.ViewSettings = project.Views.GetByName("&Gantt Chart");
+
+pdfSaveOptions.LegendItems = new PageLegendItem[]
+{
+    new PageLegendItem(BarItemType.Task, "Task"),
+    new PageLegendItem(BarItemType.ExternalMilestone, "External Milestone"),
+    new PageLegendItem(BarItemType.SummaryRollup, "Summary Rollup"),
+    new PageLegendItem(BarItemType.InactiveTask, "Inactive Task"),
+    new PageLegendItem(BarItemType.ManualSummary, "Manual Summary")
+};
+
+project.Save(OutDir + "CustomizePageLegendItems_out.pdf", pdfSaveOptions);
+```
+
 ### See Also
 
 * class [PageLegendItem](../../../aspose.tasks.visualization/pagelegenditem/)

english/net/aspose.tasks.saving/saveoptions/timescalefitbehavior/_index.md

@@ -14,6 +14,25 @@ Gets or sets a behavior which define how to align right end of the timescale wit
 public TimescaleFitBehavior TimescaleFitBehavior { get; set; }
 ```
 
+## Examples
+
+Shows how to use TimescaleFitBehavior make Gantt chart's timescale fit to the end of the last page.
+
+```csharp
+var project = new Project(DataDir + "EstimatedMilestoneTasks.mpp");
+
+var view = project.DefaultView as GanttChartView;
+
+PdfSaveOptions saveOptions = new PdfSaveOptions();
+saveOptions.PageSize = PageSize.A4;
+saveOptions.StartDate = project.StartDate;
+saveOptions.EndDate = project.FinishDate;
+saveOptions.ViewSettings = view;
+saveOptions.TimescaleFitBehavior = TimescaleFitBehavior.ScaleToEndOfPage;
+
+project.Save(OutDir + "WorkWithPageSizeDefinedInView_out.pdf", saveOptions);
+```
+
 ### See Also
 
 * enum [TimescaleFitBehavior](../../../aspose.tasks.visualization/timescalefitbehavior/)

english/net/aspose.tasks.visualization/_index.md

@@ -21,7 +21,7 @@ Contains helper classes for rendering.
 | [GanttChartColumn](./ganttchartcolumn/) | Project's view class |
 | [Gridline](./gridline/) | The horizontal or vertical line that appears in the project view. |
 | [Gridlines](./gridlines/) | Represents gridlines that appear in a GanttChart view. |
-| [HeaderFooterInfo](./headerfooterinfo/) | Represents header or footer data which is present in views and used for printing. |
+| [HeaderFooterInfo](./headerfooterinfo/) | Represents visual content of the header, footer or legend which is used for printing \ rendering of views. |
 | [PageInfo](./pageinfo/) | Represents page setup data which is present in MPP file format and used for printing. |
 | [PageLegend](./pagelegend/) | Represents a page legend which is used for project printing. |
 | [PageLegendItem](./pagelegenditem/) | Represents an item of page legend of Gantt chart. |

english/net/aspose.tasks.visualization/headerfooterinfo/_index.md

@@ -1,14 +1,14 @@
 ---
 title: Class HeaderFooterInfo
 second_title: Aspose.Tasks for .NET API Reference
-description: Aspose.Tasks.Visualization.HeaderFooterInfo class. Represents header or footer data which is present in views and used for printing
+description: Aspose.Tasks.Visualization.HeaderFooterInfo class. Represents visual content of the header footer or legend which is used for printing  rendering of views
 type: docs
 weight: 3040
 url: /net/aspose.tasks.visualization/headerfooterinfo/
 ---
 ## HeaderFooterInfo class
 
-Represents header or footer data which is present in views and used for printing.
+Represents visual content of the header, footer or legend which is used for printing \ rendering of views.
 
 ```csharp
 public class HeaderFooterInfo
@@ -24,15 +24,15 @@ public class HeaderFooterInfo
 
 | Name | Description |
 | --- | --- |
-| [CenteredImage](../../aspose.tasks.visualization/headerfooterinfo/centeredimage/) { get; set; } | Gets or sets the centered image to be displayed in the header or footer. |
+| [CenteredImage](../../aspose.tasks.visualization/headerfooterinfo/centeredimage/) { get; set; } | Gets or sets the centered image to be displayed in the parent element. |
 | [CenteredImageSize](../../aspose.tasks.visualization/headerfooterinfo/centeredimagesize/) { get; set; } | Gets or sets the displayed size of the center image. |
-| [CenteredText](../../aspose.tasks.visualization/headerfooterinfo/centeredtext/) { get; set; } | Gets or sets the centered text to display in the header or footer . |
-| [LeftImage](../../aspose.tasks.visualization/headerfooterinfo/leftimage/) { get; set; } | Gets or sets the left aligned image to be displayed in the header or footer. |
+| [CenteredText](../../aspose.tasks.visualization/headerfooterinfo/centeredtext/) { get; set; } | Gets or sets the centered text to display in the parent element. |
+| [LeftImage](../../aspose.tasks.visualization/headerfooterinfo/leftimage/) { get; set; } | Gets or sets the left aligned image to be displayed in the parent element. |
 | [LeftImageSize](../../aspose.tasks.visualization/headerfooterinfo/leftimagesize/) { get; set; } | Gets or sets the displayed size of the left image. |
-| [LeftText](../../aspose.tasks.visualization/headerfooterinfo/lefttext/) { get; set; } | Gets or sets the left aligned text to display in the header or footer. |
-| [RightImage](../../aspose.tasks.visualization/headerfooterinfo/rightimage/) { get; set; } | Gets or sets the right aligned image to be displayed in the header or footer. |
+| [LeftText](../../aspose.tasks.visualization/headerfooterinfo/lefttext/) { get; set; } | Gets or sets the left aligned text to display in the parent element. |
+| [RightImage](../../aspose.tasks.visualization/headerfooterinfo/rightimage/) { get; set; } | Gets or sets the right aligned image to be displayed in the parent element. |
 | [RightImageSize](../../aspose.tasks.visualization/headerfooterinfo/rightimagesize/) { get; set; } | Gets or sets the displayed size of the right image. |
-| [RightText](../../aspose.tasks.visualization/headerfooterinfo/righttext/) { get; set; } | Gets or sets the right aligned text to display in the header or footer. |
+| [RightText](../../aspose.tasks.visualization/headerfooterinfo/righttext/) { get; set; } | Gets or sets the right aligned text to display in the parent element. |
 
 ## Examples
 

english/net/aspose.tasks.visualization/headerfooterinfo/centeredimage/_index.md

@@ -1,14 +1,14 @@
 ---
 title: HeaderFooterInfo.CenteredImage
 second_title: Aspose.Tasks for .NET API Reference
-description: HeaderFooterInfo property. Gets or sets the centered image to be displayed in the header or footer
+description: HeaderFooterInfo property. Gets or sets the centered image to be displayed in the parent element
 type: docs
 weight: 20
 url: /net/aspose.tasks.visualization/headerfooterinfo/centeredimage/
 ---
 ## HeaderFooterInfo.CenteredImage property
 
-Gets or sets the centered image to be displayed in the header or footer.
+Gets or sets the centered image to be displayed in the parent element.
 
 ```csharp
 public Image CenteredImage { get; set; }

english/net/aspose.tasks.visualization/headerfooterinfo/centeredtext/_index.md

@@ -1,14 +1,14 @@
 ---
 title: HeaderFooterInfo.CenteredText
 second_title: Aspose.Tasks for .NET API Reference
-description: HeaderFooterInfo property. Gets or sets the centered text to display in the header or footer 
+description: HeaderFooterInfo property. Gets or sets the centered text to display in the parent element
 type: docs
 weight: 40
 url: /net/aspose.tasks.visualization/headerfooterinfo/centeredtext/
 ---
 ## HeaderFooterInfo.CenteredText property
 
-Gets or sets the centered text to display in the header or footer .
+Gets or sets the centered text to display in the parent element.
 
 ```csharp
 public string CenteredText { get; set; }

english/net/aspose.tasks.visualization/headerfooterinfo/leftimage/_index.md

@@ -1,14 +1,14 @@
 ---
 title: HeaderFooterInfo.LeftImage
 second_title: Aspose.Tasks for .NET API Reference
-description: HeaderFooterInfo property. Gets or sets the left aligned image to be displayed in the header or footer
+description: HeaderFooterInfo property. Gets or sets the left aligned image to be displayed in the parent element
 type: docs
 weight: 50
 url: /net/aspose.tasks.visualization/headerfooterinfo/leftimage/
 ---
 ## HeaderFooterInfo.LeftImage property
 
-Gets or sets the left aligned image to be displayed in the header or footer.
+Gets or sets the left aligned image to be displayed in the parent element.
 
 ```csharp
 public Image LeftImage { get; set; }