Language: HTML | XAML

So wird’s gemacht: Ändern von Standardoptionen auf der Druckvorschau-Benutzeroberfläche (XAML)

Applies to Windows only

In diesem Lernprogramm wird gezeigt, wie Sie die Druckoptionen auf der Druckvorschau-UI anpassen.

Standardmäßig werden auf der Druckvorschau-UI die folgenden Optionen angezeigt:

ColorMode Copies Orientation

 

Neben den oben genannten Einstellungen enthält Windows weitere allgemeine Druckeroptionen, die Sie der Druckvorschau-UI hinzufügen können. Diese weiteren allgemeinen Optionen lauten wie folgt.

Binding Collation Duplex HolePunch
InputBin MediaSize MediaType NUp
PrintQuality Staple   

 

Diese Optionen sind in der StandardPrintTaskOptions-Klasse definiert. Sie können in der Optionsliste, die in der Druckvorschau-Benutzeroberfläche angezeigt wird, Optionen hinzufügen oder entfernen. Sie können auch die Reihenfolge, in der die Optionen angezeigt werden, und die für den Benutzer angezeigten Standardeinstellungen ändern.

Die Änderungen, die Sie auf diese Weise vornehmen, betreffen allerdings nur die Druckvorschau-Benutzeroberfläche. Der Benutzer kann immer auf alle vom Drucker unterstützten Optionen zugreifen, indem er in der Druckvorschau-Benutzeroberfläche auf Weitere Einstellungen tippt.

Obwohl Sie in Ihrer App beliebige anzuzeigende Druckoptionen festlegen können, werden in der Druckvorschau-UI nur die vom ausgewählten Drucker unterstützten Optionen angezeigt. In der Druckbenutzeroberfläche werden keine Optionen angezeigt, die der ausgewählte Drucker nicht unterstützt.

Ziel: Passen Sie die auf der Druckvorschau-UI angezeigten Druckoptionen an.

Voraussetzungen

  • Sie müssen mit C#, C++ oder Visual Basic, XAML, Ereignissen und der Ereignisbehandlung vertraut sein.
  • Microsoft Visual Studio muss installiert sein.
  • Ein Drucker muss installiert sein.
  • Sie benötigen eine Windows Store-App mit C++, C# oder Visual Basic, deren Druckoptionen Sie ändern möchten. Falls Sie keine eigene App haben, können Sie die PrintSample-Beispiel-App herunterladen und verwenden.
  • Ihre App muss grundlegende Windows-Druckfunktionen unterstützen. Falls Sie keine App mit entsprechenden Funktionen haben, können Sie unter Schnellstart: Drucken in der App nachlesen, wie Sie Ihrer App Unterstützung für grundlegende Windows-Druckfunktionen hinzufügen.

Anweisungen

1. Öffnen der App in Visual Studio

Das Verfahren in diesem Lernprogramm bezieht sich auf die App PrintSample der PrintSample-Beispiel-App. Wenn Sie Ihrer eigenen App eine Druckschaltfläche hinzufügen, öffnen Sie anstelle der PrintSample-Beispiel-App Ihre App in Visual Studio.

  1. Öffnen Sie das Druckbeispiel für eine Windows Store-App, und laden Sie das C#-Beispiel auf Ihren Computer herunter.
  2. Klicken Sie in Visual Studio auf File > Open Project, und navigieren Sie zu dem Ordner, der die Projektmappendatei der im vorhergehenden Schritt heruntergeladenen Beispiel-App enthält.
  3. Wählen Sie die Projektmappendatei PrintSample aus, und klicken Sie auf Öffnen.

2. Erstellen und Testen der App

  1. Klicken Sie auf Erstellen > Projektmappe erstellen, um die App zu erstellen. Stellen Sie sicher, dass unten auf dem Bildschirm keine Fehlermeldungen im Ausgabebereich angezeigt werden.
  2. Klicken Sie auf Debug > Starten ohne Debugging.
  3. Vergewissern Sie sich, dass nach einigen Sekunden die App Print JS Sample angezeigt wird.
  4. Wenn die App ohne Fehler ausgeführt wird, kehren Sie zu Visual Studio zurück, und klicken Sie auf Debuggen > Debugging beenden.

3. Definieren der anzuzeigenden Druckoptionen

Wenn der Bildschirm der App geladen wird, wird die App für den Vertrag für "Drucken" registriert. Im Rahmen dieser Registrierung wird der PrintTaskRequested-Ereignishandler definiert. Der Code zum Anpassen der in der Druckvorschau-Benutzeroberfläche angezeigten Optionen wird dem PrintTaskRequested-Ereignishandler hinzugefügt.

Ändern Sie den PrintTaskRequested-Ereignishandler, um ihm die printTask.options-Anweisungen hinzuzufügen, mit denen die in der Druckvorschau-Benutzeroberfläche anzuzeigenden Druckeinstellungen konfiguriert werden.

  1. Überschreiben Sie für den Bildschirm Ihrer App, auf dem Sie eine benutzerdefinierte Liste von Druckoptionen anzeigen möchten, den PrintTaskRequested-Ereignishandler in der Basisklasse, um Code zum Angeben der Optionen hinzuzufügen, die bei der Ausgabe des Bildschirms angezeigt werden sollen.

    Hinweis  Dieses Beispiel stammt aus der Datei ScenarioInput3.xaml.cs der PrintSample-Beispiel-App. Weisen Sie die Druckoptionen zu, die Benutzern auf der Druckvorschau-UI angezeigt werden sollen, wenn Sie Ihrer App diesen Code hinzufügen.
    Wichtig  Wenn die displayedOptions.clear()-Methode aufgerufen wird, werden alle Druckoptionen aus der Druckvorschau-Benutzeroberfläche entfernt, auch der Link Weitere Einstellungen. Fügen Sie alle Optionen an, die in der Druckvorschau-Benutzeroberfläche angezeigt werden sollen.
    
    protected override void PrintTaskRequested(PrintManager sender, PrintTaskRequestedEventArgs e)
    {
        PrintTask printTask = null;
        printTask = e.Request.CreatePrintTask("C# Printing SDK Sample", 
                                              sourceRequestedArgs =>
                                              {
                                                  IList<string> displayedOptions = printTask.Options.DisplayedOptions;
    
                                                  // Choose the printer options to be shown.
                                                  // The order in which the options are appended determines the order in which they appear in the UI
                                                  displayedOptions.Clear();
                                                  displayedOptions.Add(Windows.Graphics.Printing.StandardPrintTaskOptions.Copies);
                                                  displayedOptions.Add(Windows.Graphics.Printing.StandardPrintTaskOptions.Orientation);
                                                  displayedOptions.Add(Windows.Graphics.Printing.StandardPrintTaskOptions.MediaSize);
                                                  displayedOptions.Add(Windows.Graphics.Printing.StandardPrintTaskOptions.Collation);
                                                  displayedOptions.Add(Windows.Graphics.Printing.StandardPrintTaskOptions.Duplex);
    
                                                  // Preset the default value of the printer option
                                                  printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;
                                                  
                                                  // Print Task event handler is invoked when the print job is completed.
                                                  printTask.Completed += async (s, args) =>
                                                  {
                                                      // Notify the user when the print operation fails.
                                                      if (args.Completion == PrintTaskCompletion.Failed)
                                                      {
                                                          await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
                                                          {
                                                              rootPage.NotifyUser("Failed to print.", NotifyType.ErrorMessage);
                                                          });
                                                      }
                                                  };
    
                                                  sourceRequestedArgs.SetSource(printDocumentSource);
                                              });
    }
    
    
    
  2. Sie können auch die Standardwerte der Optionen in der Druckvorschau-Benutzeroberfläche festlegen. Die folgende Codezeile aus dem obigen Codebeispiel legt den Standardwert der Option MediaSize fest.

    
    // Preset the default value of the printer option
    printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;
    
    
    

Zusammenfassung und nächste Schritte

Den vollständigen Quellcode für dieses und andere Druckszenarien mit Windows Store-Apps finden Sie in der PrintSample-Beispiel-App.

Verwandte Themen

Drucken

 

 

Anzeigen:
© 2015 Microsoft