Convertir les données du projet en PDF

Aspose.Tasks pour l’API C ++ offre la capacité de rendre les données du projet au format PDF. Cet article donne un aperçu détaillé de la variété des options disponibles dans Aspose. Tasks pour l’exportation de projets vers PDF.

Sauver un projet en tant que PDF

La classe Project expose la méthode de sauvegarde qui est utilisée pour enregistrer un projet dans divers formats. La méthode de sauvegarde vous permet de rendre des données de projet sur PDF à l’aide du type d’énumération SaveFileFormat.

Pour enregistrer un projet sur PDF:

1. Chargez un fichier de projet Microsoft.
2. Enregistrez le projet sur PDF à l’aide de SaveFileFormat.pdf.

Les lignes de code suivantes montrent comment y parvenir en utilisant C ++.

// Read the input Project file
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CreateProject2.mpp");
    
// Save the Project as PDF
project->Save(dataDir + u"SaveProjectAsPDF_out.pdf", Aspose::Tasks::Saving::SaveFileFormat::PDF);

Fitting Contents to Cell Size

It is common that a task (or resource) name is so long that it is truncated when project views are rendered. Aspose.Tasks for C++ API provides the FitContent property in the SaveOptions class to avoid truncation of task and resource names. The code example given below renders a project to PDF format with the FitContent property set to true.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CreateProject2.mpp");
System::SharedPtr<SaveOptions> saveOptions = System::MakeObject<PdfSaveOptions>();
    
// Set option fit content to true
saveOptions->set_FitContent(true);
saveOptions->set_Timescale(Aspose::Tasks::Visualization::Timescale::Months);
saveOptions->set_PresentationFormat(Aspose::Tasks::Visualization::PresentationFormat::TaskUsage);
project->Save(dataDir + u"FitContentsToCellSize_out.pdf", saveOptions);

Printing or Hiding Legends when Rendering

To let you print or hide the legends on each page, the SaveOptions class provides the LegendOnEachPage property. If this flag is set to true, legends are printed on each page in the output file.

System::SharedPtr<SaveOptions> saveOptions = System::MakeObject<PdfSaveOptions>();
    
// Set the LegendOnEachPage property to false to hide legends
saveOptions->set_LegendOnEachPage(false);

Supported Graphical Column Indicators

Aspose.Tasks for C++ API draws graphical column indicators when rendering project data to output PDF. The following graphical indicators are supported by Aspose.Tasks:

Indicator Type	Graphical Indicator
Task Indicators
Resource Indicators
Assignment Indicators

Saving to Multiple PDF Files

To save project data to multiple PDF files, set the SaveToSeparateFiles flag to true.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"Software Development Plan.mpp");
System::SharedPtr<PdfSaveOptions> saveOptions = System::MakeObject<PdfSaveOptions>();
saveOptions->set_SaveToSeparateFiles(true);
saveOptions->set_Pages(System::MakeObject<System::Collections::Generic::List<int32_t>>());
saveOptions->get_Pages()->Add(1);
saveOptions->get_Pages()->Add(4);
project->Save(dataDir + u"SaveToMultiplePDFFiles_out.pdf", System::StaticCast<Aspose::Tasks::Saving::SaveOptions>(saveOptions));

Customizing TextStyle for Project Data

Aspose.Tasks for C++ API allows developers to customize the text style for overallocated resources. By default, the style used for overallocated resources is similar to Microsoft Project (MSP), that is, red and bold. TextItemType.OverallocatedResources makes it possible to customize the color and style for the overallocated resources.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CreateProject2.mpp");
System::SharedPtr<SaveOptions> options = System::MakeObject<PdfSaveOptions>();
options->set_PresentationFormat(Aspose::Tasks::Visualization::PresentationFormat::ResourceSheet);
    
System::SharedPtr<TextStyle> style = System::MakeObject<TextStyle>();
style->set_Color(System::Drawing::Color::get_OrangeRed());
style->set_FontStyle(System::Drawing::FontStyle::Bold);
System::setter_or_wrap(style.GetPointer(), &TextStyle::get_FontStyle, &TextStyle::set_FontStyle, System::Drawing::FontStyle::Italic);
style->set_ItemType(Aspose::Tasks::Visualization::TextItemType::OverallocatedResources);
    
options->set_TextStyles(System::MakeObject<System::Collections::Generic::List<System::SharedPtr<TextStyle>>>());
options->get_TextStyles()->Add(style);
project->Save(dataDir + u"CustomizeTextStyle_out.pdf", options);

Customizing Date Formats

Aspose.Tasks for C++ API allows developers to customize the date format using the DateFormat enumerator when rendering project data.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CreateProject2.mpp");
    
auto options = [&]{ auto tmp_0 = System::MakeObject<PdfSaveOptions>(); tmp_0->set_PresentationFormat(Aspose::Tasks::Visualization::PresentationFormat::GanttChart); tmp_0->set_FitContent(true); tmp_0->set_UseProjectDefaultFont(false); tmp_0->set_DefaultFontName(u"Segoe UI Black"); return tmp_0; }();
project->Save(dataDir + u"CreateProject2_out.pdf", System::StaticCast<Aspose::Tasks::Saving::SaveOptions>(options));

Setting Default Font

Setting default font during rending of documents helps when a font is not found. In such a case, the default font replaces the missing font, and output is not affected. Aspose.Tasks for C++ API lets you specify the default font using the DefaultFontName property of the PdfSaveOptions as shown in the following code sample.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CreateProject2.mpp");
project->Set(Prj::StartDate(), System::DateTime(2014, 9, 22));
    
// By default project.DateFormat == DateFormat.Date_ddd_mm_dd_yy (Mon 09/22/14) customize DateFormat (September 22, 2014)
project->Set<DateFormat>(Prj::DateFormat(), Aspose::Tasks::DateFormat::DateMmmmDdYyyy);
project->Save(dataDir + u"CustomizeDateFormats1_out.pdf", Aspose::Tasks::Saving::SaveFileFormat::PDF);
    
// Export to date format 19/07/2016
project->Set<DateFormat>(Prj::DateFormat(), Aspose::Tasks::DateFormat::DateDdMmYyyy);
project->Save(dataDir + u"CustomizeDateFormats2_out.pdf", Aspose::Tasks::Saving::SaveFileFormat::PDF);