Tipps & Tricks - Hinzufügen eines einfachen Druckbuttons über den Customizer

Im Customizer steht unter „Customizer“ – „Aktionen" - "Drucken"“ ein speziell für den Customizer entwickelter Button mit dem Namen „SimplePrintButton“ zur Verfügung. Dieser Button kann auf eine beliebige Maske gezogen werden und stellt dort nach der Konfiguration der Eigenschaften die Möglichkeit zum Drucen eines Belegs oder Etiketts zur Verfügung.

Eigenschaften des SimplePrintButton im Bereich "Druckparameter"

Dabei können folgende Eigenschaften im Bereich „Druckparameter“ für diesen Button gesetzt werden:

• Copies= Anzahl der zu druckenden Exemplare des Belegs oder Etiketts. Der Standardwert für diesen Parameter ist 1.
• FileFormat = Das Dateiformat der Ausgabedatei für den Mode "PrintToFile", welches über ein Dropdownmenü ausgewählt werden kann.
• FileFullPath = Der komplette Pfad der Ausgabedateifür den Mode "PrintToFile", wobei auch die Umgebungsvariablen von Windows im Pfad verwendet werden können.

Beispiel:

FileFullPath = %userprofile%\Desktop\SIMPLEPRINTBUTTON.PDF"

Durch die Angabe von "%userprofile%\Desktop" wird automatisch auf den Desktop des aktuellen Benutzers zugegriffen und dort das PDF 2SIMPLEPRINTBUTTON" abgelegt.

• Mode = Legt das Druckziel für den Druck über den Button fest. Zur Auswahl stehen die folgenden Möglichkeiten

  • PrintToPrinter - Ausdruck an einem physischen/virtuellen Drucker [Standardwert

  • PrintToScreen - Bildschirmdruck

  • PrintToFile - Datei speichern als

• OrderByClause = Angabe der Sortierung für das SQL-Statement, welches zur Ermittlung der Daten des Berichts ausgeführt wird.

Achtung:

Passt die in der OrderByClause angegebene Einschränkung nicht zum zu druckenden Beleg oder Etikett, kann es zu SQL-Fehlern kommen.

• PrinterName = Name des Druckers, über den der Ausdruck erfolgen soll, wenn direkt auf einen Drucker gedruckt wird. Sollte kein Drucker angegeben werden, dann wird immer der aktuelle Standarddrucker verwendet.

Achtung:

Dieser Parameter wird nicht berücksichtigt, wenn der Parameter "PrintToScreen" und/ oder der Parameter "ShowPrintDialog" auf "True" gesetzt wurde.

• ReportLayout = Explizite Angabe einer *.lst-Datei oder *.lbl-Datei des zu druckenden Belegs oder Etiketts. Sollte keine *.lst-Datei oder *.lbl-Datei angegeben werden, dann wird immer die in der Reportdefinition im iReport bzw. der Tabelle REPYOURSELF hinterlegte *.lst-Datei oder *.lbl-Datei verwendet.

Achtung:

Wird eine *.lst-Datei oder *.lbl-Datei angegeben, welche nicht über den Dialog "Reports benennen" bzw. die Tabelle REPREPORTS einer Reportdefintion zugeordnet ist, wird dieser Parameter nicht berücksichtigt und stattdessen die bei der Reportdefinition hinterlegte *.lst-Datei oder *.lbl-Datei verwendet.

• ReportNumber = Interne laufende Nummer der Reportdefinition aus dem iReport bzw. der Tabelle REPYOURSELF des zu druckenden Belegs oder Etiketts.

Achtung:

Wird unter "ReportLayout" eine *.lst-Datei oder *.lbl-Datei angegeben, welche weder direkt der hier angegebenen Reportdefinition hinterlegt ist, noch dieser Reportdefinition über den Dialog "Reports benennen" bzw. die Tabelle REPREPORTS zugeordnet ist, wird dieser Parameter nicht berücksichtigt und stattdessen die Reportdefition verwendet, welcher die unter  "ReportLayout" hinterlegte *.lst-Datei oder *.lbl-Datei zugeordnet ist.

• PrintHeaderFooter = Kennzeichen, ob der Kopf- und Fußbereich auf einen Beleg oder ein Etikett gedruckt werden soll:
  • True = Kopf- und Fußbereich wird auf den Beleg / das Etikett gedruckt
  • False = Kopf- und Fußbereich wird nicht auf den Beleg / das Etikett gedruckt'

Der Standardwert für diesen Parameter ist "false".

• PrintLogo = Kennzeichen, ob das Logo auf einen Beleg oder ein Etikett gedruckt werden soll:
  • True = Logo wird auf den Beleg / das Etikett gedruckt
  • False = Logo wird nicht auf den Beleg / das Etikett gedruckt

  Der Standardwert für diesen Parameter ist "false".

• PrintInfo = Zusätzliche Information zum Ausdruck, wie z.B. "Artikeletikett", welche u.a. im Dialog "Drucken" in der Spalte "Info" bzw. dem "PrintInfoTitle " angegeben Namen, angezeigt wird.
• PrintInfoTitle = Titel für die zusätzliche Information beim Drucken aus dem Parameter "PrintInfo", welcher z.B. im Dialog "Drucken" angezeigt wird. Sollte kein Titel angegeben werden, sondern nur ein Wert für "PrintInfo" eingetragen werden, dann wird als Titel immer "Info" verwendet.

• ShowPrintDialog: Kennzeichen, ob der Dialog "Drucken" angezeigt werden soll:
  • True = Der Dialog "Drucken" wird angezeigt, wo noch einmal vor dem Ausdruck diverse Einstellungen gesetzt oder übersteuert werden können

  Achtung:

  Die Einstellungen aus den Parametern "PrinterName" und "PrintToScreen" werden in diesem Fall nicht mehr berücksichtigt.

  • False = Der Dialog "Drucken" wird nicht angezeigt und es erfolgt je nach Einstellung direkt ein Ausdruck auf den Drucker oder Bildschirm

  Der Standardwert für diesen Parameter ist "false", sodass je nach Einstellung direkt auf den Drucker oder Bildschirm gedruckt wird.

• UseAppServer = Kennzeichen, ob der Ausdruck zwingend über den Applikationsserver erfolgen soll:
  • True = Der Ausdruck erfolgt immer über den Applikationsserver, die Druckziele "Bildschirm" und "Drucker" stehen daher auch im Dialog "Drucken" nicht mehr zur Verfügung.

  Achtung:

  Beim Druck im Applikationsserver werden i.d.R. die im Applikationsserver hinterlegten Einstellungen verwendet, so dass z.B. der unter "PrinterName" hinterlegte Drucker nur berücksichtigt wird , wenn im Applikationsserver kein Eintrag für die hinterlegte Reportdefinition bzw. ein Standarddrucker für den Druck über den Applikationsserver hinterlegt ist und "ShowPrintDialog" auf "false" gesetzt ist.

  • False = Der Ausdruck erfolgt nie über den Applikationsserver, das Druckziel "Applikationsserver" steht daher auch im Dialog "Drucken" nicht mehr zur Verfügung,

  Der Standardwert für diesen Parameter ist "false", sodass nicht über den Applikationsserver gedruckt werden kann.

• WhereClause = Einschränkung für das SQL-Statement, welches zur Ermittlung der Daten des Belegs oder Etiketts ausgeführt werden soll.

Achtung

Passt die in der "WhereClause" angegebene Einschränkung nicht zum zu druckenden Beleg oder Etikett, kann es zu SQL-Fehlern kommen.

Events des SimplePrintButton im Bereich "Druckaktion"

Diese Eigenschaften können über die Events "BeforePrint" und "AfterPrint" in der Kategorie "Druckaktion" dynamisch überschrieben werden:

• BeforePrint = Wird vor der Druckaktion ausgelöst, sodass hier dynamisch veränderliche Druckparameter gesetzt werden können, wie z.B. die "WhereClause" . Die Event-Argumente haben u.a. eine Eigenschaft "Cancel". Wird diese in der Event-Methode von "BeforePrint" auf "true" gesetzt, dann wird der Druckvorgang abgebrochen.

Hinweis:

Hierbei handelt es sich um das Standard-Event des Buttons, sodass der Code mit einem Doppelklick auf den Button im Designer geöffnet werden kann.

Beispiel:

Die "WhereClause" muss in vielen Fällen dynamisch ermittelt werden, weil sich die zu druckenden Daten i.d.R. dynamisch sind, wie z.B. beim Druck eines Lieferscheins, wo die Lieferscheinnummer dynamisch ermittelt werden soll:

public void newSimplePrintButton1_BeforePrint(object sender, SimplePrintButton.SimplePrintButtonEventArgs e)

{

if (frmAngauf.fnLSNr.IsEmpty())

{

e.Cancel = true;

return;

}

newSimplePrintButton1.WhereClause = "AAGLSPOS.LSNR = " + frmAngauf.fnLSNr.Text;

}

• AfterPrint = Wird nach der Druckaktion ausgelöst.

Hier finden Sie ein Beispiel für die Verwendung des "SimplePrintButtons":

• Beispiel: SimplePrintButton hinzufügen und über Events und Eigenschaften im Customizer konfigurieren

Verwandte Themen

Aufrufen des Customizers

Controls in TabControls einfügen

Einfügen von neuen Controls

Einstellungen wiederherstellen

Schaltflächen bearbeiten

Tabellen bearbeiten

Tipps & Tricks - Customizing der eingebetteten Positionsmaske in der Auftragsverwaltung

Tipps & Tricks - Hinzufügen der Aktenfunktionalität über den Customizer

Tipps & Tricks - Hinzufügen eines Chrome Browsers