Working with Page Header Footer

Reading Header and Footer Information from MPP file

Aspose.Tasks for .NET API provides the capability to read the Header and Footer information from MPP file. The API includes dedicated classes that correspond to each tab of the Microsoft Project Page Setup dialog:

• Microsoft Project Page Setup dialog box has 6 tabs. These tabs are mapped to new classes:
  • Page tab -> PageSettings -> Aspose.Tasks.Visualization.PageSettings class
  • Margins tab -> PageMargins -> Aspose.Tasks.Visualization.PageMargins class
  • Header, footer tabs -> HeaderFooterInfo -> Aspose.Tasks.Visualization.HeaderFooterInfo class
  • Legend tab -> PageLegend -> Aspose.Tasks.Visualization.PageLegend class
  • View tab -> PageViewSettings -> Aspose.Tasks.Visualization.PageViewSettings class

The following example demonstrates how to read header and footer information from an MPP file:

static void Run()
{
    // Create project and project info instances
    Project project = new Project("New Project.mpp");
    PageInfo info = project.DefaultView.PageInfo;

    Console.WriteLine("Page data cannot be null : {0} ", !info.Equals(null));

    if (info != null)
    {
        AssertHeaderFooterCorrect(info);
        AssertPageSettingsCorrect(info);
        AssertPageViewSettingsCorrect(info);
        AssertMarginsCorrect(info);
        AssertLegendCorrect(info);
    }
 
}

static void AssertHeaderFooterCorrect(PageInfo info)
{
    Console.WriteLine("Header left text Equals LEFT HEADER : {0} ", info.Header.LeftText.Equals("LEFT HEADER"));
    Console.WriteLine("Header center text Equals CENTER HEADER : {0} ", info.Header.CenteredText.Equals("CENTER HEADER"));
    Console.WriteLine("Header right text Equals RIGHT HEADER : {0} ", info.Header.RightText.Equals("RIGHT HEADER"));

    Console.WriteLine("Footer left text Equals LEFT FOOTER : {0} ", info.Footer.LeftText.Equals("LEFT FOOTER"));
    Console.WriteLine("Footer center text Equals CENTER FOOTER : {0} ", info.Footer.CenteredText.Equals("CENTER FOOTER"));
    Console.WriteLine("Footer right text Equals RIGHT FOOTER : {0} ", info.Footer.RightText.Equals("RIGHT FOOTER"));
}

static void AssertPageSettingsCorrect(PageInfo info)
{
    Console.WriteLine("Portrait Orientation is Portrait : {0} ", info.PageSettings.IsPortrait.Equals(true));
    Console.WriteLine("AdjustToPercentOfNormalSize is enabled : {0} ", info.PageSettings.AdjustToPercentOfNormalSize.Equals(true));
 
    Console.WriteLine("PercentOfNormalSize Equals 150 : {0} ", info.PageSettings.PercentOfNormalSize.Equals(150));
    Console.WriteLine("PagesInWidth Equals 3 : {0} ", info.PageSettings.PagesInWidth.Equals(3));
    Console.WriteLine("PagesInHeight Equals 7 : {0} ", info.PageSettings.PagesInHeight.Equals(7));
    Console.WriteLine("PaperSize Equals PaperA4 : {0} ", info.PageSettings.PaperSize.Equals(PrinterPaperSize.PaperA4));
    Console.WriteLine("FirstPageNumber : {0} ", info.PageSettings.FirstPageNumber);
}

static void AssertPageViewSettingsCorrect(PageInfo info)
{
    Console.WriteLine("PrintAllSheetColumns is set to false : {0} ", info.PageViewSettings.PrintAllSheetColumns.Equals(false));
    Console.WriteLine("PrintFirstColumnsCountOnAllPages is set to true : {0} ", info.PageViewSettings.PrintFirstColumnsCountOnAllPages.Equals(true));

    Console.WriteLine("FirstColumnsCount Equals 3 : {0} ",  info.PageViewSettings.FirstColumnsCount.Equals(3));
    Console.WriteLine("PrintNotes is set to true : {0} ", info.PageViewSettings.PrintNotes.Equals(true));
    Console.WriteLine("PrintBlankPages is set to false : {0} ", info.PageViewSettings.PrintBlankPages.Equals(false));
    Console.WriteLine("FitTimescaleToEndOfPage is set to true : {0} ", info.PageViewSettings.FitTimescaleToEndOfPage.Equals(true));
}

static void AssertMarginsCorrect(PageInfo info)
{
    Console.WriteLine("Margins.Left Equals 1 : {0} ", (info.Margins.Left - 1 <= 1e-5) ? true : false);
    Console.WriteLine("Margins.Top Equals 1.1 : {0} ", (info.Margins.Top - 1.1 <= 1e-5) ? true : false);
    Console.WriteLine("Margins.Right Equals 1.2 : {0} ", (info.Margins.Right - 1.2 <= 1e-5) ? true : false);
    Console.WriteLine("Margins.Bottom Equals 1.2 : {0} ", (info.Margins.Bottom - 1.3 <= 1e-5) ? true : false);

    Console.WriteLine("Margin.Borders Equals Border.AroundEveryPage : {0} ",info.Margins.Borders.Equals(Border.AroundEveryPage));
}

static void AssertLegendCorrect(PageInfo info)
{
    Console.WriteLine("Legend left text Equals LEFT LEGEND : {0} ", info.Legend.LeftText.Equals("LEFT LEGEND"));
    Console.WriteLine("Legend center text Equals CENTER LEGEND : {0} ", info.Legend.CenteredText.Equals("CENTER LEGEND"));
    Console.WriteLine("Legend right text Equals RIGHT LEGEND : {0} ", info.Legend.RightText.Equals("RIGHT LEGEND"));

    Console.WriteLine("LegendOn Equals Legend.OnEveryPage : {0} ", info.Legend.LegendOn.Equals(Legend.OnEveryPage));
    Console.WriteLine("Legend Width Equals 5 : {0} ", (info.Legend.Width - 5 <= 1e-5) ? true : false);
}

Adding Image to Page Header/Footer

Aspose.Tasks for .NET also provides the ability to manipulate page headers and footers, including inserting images. The example below shows how to add an image to a page header:

Project project = new Project("New Project.mpp");

project.RootTask.Children.Add("Task1");
PageInfo pageInfo = project.DefaultView.PageInfo;

using (Image image = Image.FromFile("Image1.png"))
{
    pageInfo.Header.CenteredImage = image;
    pageInfo.Legend.LeftImage = image;
    pageInfo.Legend.LeftText = string.Empty;
    MPPSaveOptions options = new MPPSaveOptions();
    options.WriteViewData = true;
    project.Save("AddImageToPageHeaderFooter_out.mpp", options);
}

By using Aspose.Tasks for .NET, developers gain full control over the page setup, including headers, footers, margins, legends, and view settings.
This flexibility enables the creation of professional reports and print layouts programmatically, ensuring that project documentation meets organizational standards without requiring manual adjustments in Microsoft Project.