IXpsFixedPageWriter Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert Methoden zum Schreiben von FixedPage Teilen in ein XPS-Dokument.
public interface class IXpsFixedPageWriter : System::Windows::Xps::Packaging::IStoryFragmentProvider
public interface IXpsFixedPageWriter : System.Windows.Xps.Packaging.IStoryFragmentProvider
type IXpsFixedPageWriter = interface
interface IStoryFragmentProvider
Public Interface IXpsFixedPageWriter
Implements IStoryFragmentProvider
- Implementiert
Beispiele
Das folgende Beispiel zeigt, wie Sie die AddFixedPage Methode verwenden, um einen Writer mit fester Seite zum Hinzufügen von Seiten zu einem XpsDocument.
// ------------------------- AddDocumentContent ---------------------------
/// <summary>
/// Adds a predefined set of content to a given document writer.</summary>
/// <param name="fixedDocumentWriter">
/// The document writer to add the content to.</param>
void AddDocumentContent (IXpsFixedDocumentWriter^ fixedDocumentWriter)
{
// Collection of image and font resources used on the current page.
// Key: "XpsImage", "XpsFont"
// Value: List of XpsImage or XpsFont resources
Dictionary<System::String^,List<XpsResource^>^>^ resources;
try
{
// Add Page 1 to current document.
IXpsFixedPageWriter^ fixedPageWriter = fixedDocumentWriter->AddFixedPage();
// Add the resources for Page 1 and get the resource collection.
resources = AddPageResources(fixedPageWriter);
// Write page content for Page 1.
WritePageContent(fixedPageWriter->XmlWriter, "Page 1 of " + fixedDocumentWriter->Uri->ToString(), resources);
// Commit Page 1.
fixedPageWriter->Commit();
// Add Page 2 to current document.
fixedPageWriter = fixedDocumentWriter->AddFixedPage();
// Add the resources for Page 2 and get the resource collection.
resources = AddPageResources(fixedPageWriter);
// Write page content to Page 2.
WritePageContent(fixedPageWriter->XmlWriter, "Page 2 of " + fixedDocumentWriter->Uri->ToString(), resources);
// Commit Page 2.
fixedPageWriter->Commit();
} catch (XpsPackagingException^ xpsException)
{
throw xpsException;
}
};// end:AddDocumentContent()
// ------------------------- AddDocumentContent ---------------------------
/// <summary>
/// Adds a predefined set of content to a given document writer.</summary>
/// <param name="fixedDocumentWriter">
/// The document writer to add the content to.</param>
private void AddDocumentContent(IXpsFixedDocumentWriter fixedDocumentWriter)
{
// Collection of image and font resources used on the current page.
// Key: "XpsImage", "XpsFont"
// Value: List of XpsImage or XpsFont resources
Dictionary<string, List<XpsResource>> resources;
try
{
// Add Page 1 to current document.
IXpsFixedPageWriter fixedPageWriter =
fixedDocumentWriter.AddFixedPage();
// Add the resources for Page 1 and get the resource collection.
resources = AddPageResources(fixedPageWriter);
// Write page content for Page 1.
WritePageContent(fixedPageWriter.XmlWriter,
"Page 1 of " + fixedDocumentWriter.Uri.ToString(), resources);
// Commit Page 1.
fixedPageWriter.Commit();
// Add Page 2 to current document.
fixedPageWriter = fixedDocumentWriter.AddFixedPage();
// Add the resources for Page 2 and get the resource collection.
resources = AddPageResources(fixedPageWriter);
// Write page content to Page 2.
WritePageContent(fixedPageWriter.XmlWriter,
"Page 2 of " + fixedDocumentWriter.Uri.ToString(), resources);
// Commit Page 2.
fixedPageWriter.Commit();
}
catch (XpsPackagingException xpsException)
{
throw xpsException;
}
}// end:AddDocumentContent()
' ------------------------- AddDocumentContent ---------------------------
''' <summary>
''' Adds a predefined set of content to a given document writer.</summary>
''' <param name="fixedDocumentWriter">
''' The document writer to add the content to.</param>
Private Sub AddDocumentContent(ByVal fixedDocumentWriter As IXpsFixedDocumentWriter)
' Collection of image and font resources used on the current page.
' Key: "XpsImage", "XpsFont"
' Value: List of XpsImage or XpsFont resources
Dim resources As Dictionary(Of String, List(Of XpsResource))
Try
' Add Page 1 to current document.
Dim fixedPageWriter As IXpsFixedPageWriter = fixedDocumentWriter.AddFixedPage()
' Add the resources for Page 1 and get the resource collection.
resources = AddPageResources(fixedPageWriter)
' Write page content for Page 1.
WritePageContent(fixedPageWriter.XmlWriter, "Page 1 of " & fixedDocumentWriter.Uri.ToString(), resources)
' Commit Page 1.
fixedPageWriter.Commit()
' Add Page 2 to current document.
fixedPageWriter = fixedDocumentWriter.AddFixedPage()
' Add the resources for Page 2 and get the resource collection.
resources = AddPageResources(fixedPageWriter)
' Write page content to Page 2.
WritePageContent(fixedPageWriter.XmlWriter, "Page 2 of " & fixedDocumentWriter.Uri.ToString(), resources)
' Commit Page 2.
fixedPageWriter.Commit()
Catch xpsException As XpsPackagingException
Throw xpsException
End Try
End Sub
Eigenschaften
| Name | Beschreibung |
|---|---|
| LinkTargetStream |
Ruft eine Liste der Zeichenfolgen ab, die die LinkTarget Hyperlinkpunkte identifizieren, die auf der aktuellen Seite enthalten sind. |
| PageNumber |
Ruft die nullbasierte Seitenzahl dieser Seite ab. |
| PrintTicket |
Legt die Standarddruckoptionen für die Seite fest. |
| Uri |
Ruft den URI der festen Seite ab. |
| XmlWriter |
Ruft ein zum Schreiben von XmlWriter XML-Markup auf die Seite ab. |
Methoden
| Name | Beschreibung |
|---|---|
| AddColorContext() |
Fügt der aktuellen Seite eine neue XpsColorContext hinzu. |
| AddFont() |
Fügt der aktuellen Seite eine neue XpsFont hinzu. |
| AddFont(Boolean, Boolean) |
Fügt der aktuellen Seite eine neue verschleierte oder eingeschränkte XpsFont Option hinzu. |
| AddFont(Boolean) |
Fügt der aktuellen Seite eine neue verschleierte XpsFont Seite hinzu. |
| AddImage(String) |
Fügt der aktuellen Seite einen neuen XpsImage mit einem angegebenen MIME-Typ hinzu. |
| AddImage(XpsImageType) |
Fügt der aktuellen Seite ein neues XpsImage Mit einem angegebenen XpsImageType Hinzufügt. |
| AddResource(Type, Uri) |
Fügt der aktuellen Seite eine neue XpsResource hinzu. |
| AddResourceDictionary() |
Fügt der Seite eine XpsResourceDictionary hinzu. |
| AddStoryFragment() |
Fügt ein StoryFragments Element zu einem XPS-Paket hinzu. (Geerbt von IStoryFragmentProvider) |
| AddThumbnail(XpsImageType) |
Fügt der aktuellen Seite ein Miniaturbild eines angegebenen XpsImageType Bilds hinzu. |
| Commit() |
Löscht und schließt den Writer mit fester Seite. |