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 has classes mapped to each tab of Microsoft Project Page Setup dialog as detailed in the section below.

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

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 API provides the capability to manipulate the document’s page header and footer information. The example below shows how to add image to page’s 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);
}