Drucken & Layouts

3.1.106 IAutoDrucken Interface

Dieses SpecialObject ist für die Druckgenerierung verantwortlich.

IDL

[ uuid(77A19B21-6732-444D-844F-299FCF056BDD), version(1.0), dual, oleautomation ]
interface IAutoDrucken : IAutoBase;

Beschreibung

Ab Build: 3855.

Dieses Objekt bildet die Grundlage für den Druck. Es wird analog zu den anderen SpecialObjects erstellt.

Drucken : AutoSpecialDrucken;
Drucken := (AutoApplication.GetSpecialObject(soDrucken) as AutoSpecialDrucken);

Voraussetzungen für das Druck-Objekt

Bitte beachten Sie, dass für das erfolgreiche Erstellen des Druck-Objektes Bedingungen erfüllt sein müssen:

Sie benötigen einen COM-Aktiv-Developer Vertrag.
Sie benötigen die für Sie zutreffende Menge an Lizenzen und die korrekte Version von List & Label (combit GmbH www.combit.net).
Es wird ein zusätzlicher Vertrag benötigt, der die Zusammenarbeit und Bedingungen der Nutzung klärt. Dieser Vertrag kann unter der E-Mail-Adresse angefordert werden.
Es wird eine RDU-Lizenz für die Verwendung des Druck-Objektes benötigt (Remote Desktop Arbeitsplätze).

Warum wird ein zusätzlicher Vertrag notwendig?

Hersteller des Druckmoduls ist die combit GmbH. Die Lizenzbedingungen können auf der Webseite http://www.combit.net/lizenzvertrag eingesehen werden. Um unsererseits die Lizenzbedingungen des Druckmodulherstellers zu erfüllen, ist eine Zusammenarbeit mit der combit GmbH erforderlich. Der Vertrag regelt unsere Position zum Hersteller und zu Ihnen als "Endverbraucher". Eine Weitergabe der Funktionen (egal in welchem Umfang) ist nur mit einer individuellen Vereinbarung gestattet.

Warum wird eine RDU-Lizenz zum Drucken fällig?

Diese Lizenz wird immer dann benötigt, wenn ein Druck automatisiert ausgeführt werden kann (zum Beispiel ohne Benutzerinteraktion).

Ablauf:

Setzen Sie sich mit der E-Mail-Adresse in Verbindung. Wir werden mit Ihnen zusammen alle anstehenden Punkte klären.

Sie erhalten auf Nachfrage von uns den zusätzlichen Vertrag zur Verwendung des Druck-Objektes.
Sie erwerben ausreichend Lizenzen von combit.
Teilen Sie uns Ihre Registrierungsinformationen bei combit mit: Ihren Firmennamen, Ihre Adresse, Ausbaustufe / Name der List & Label Lizenz, Ihre Seriennummer.
Wir fragen bei combit an, ob Sie mit den uns genannten Daten zum Zugriff berechtigt sind.
Nach der erfolgreichen Prüfung sind Sie bis zum Ende Ihrer Lizenz von combit zum Zugriff auf das Druck-Objekt berechtigt.

Anmerkungen

Sobald Sie das Drucken-Objekt erstellen, wird eine Remote-Desktop-Lizenz für Ihre Verbindung verwendet. Ist keine Lizenz vorhanden oder sind alle Remotelizenzen in Verwendung, wird das Objekt nicht erstellt. Wenn das Erstellen funktionierte, bleibt Ihre Anmeldung bis zum Beenden der COM-Instanz als Remote-Zugriff registriert.

Beispiel (Delphi)

function TVorgangDruck.DoExecute(aDirect: Boolean): Boolean;
var
  Drucken : AutoSpecialDrucken;
  Group : AutoDruckenLayoutGroup;
  Layout: AutoDruckLayout;
  Buffer : string;
  tbl: AutoDataSet;
begin
  Result := False;
  Drucken := (BpApp.GetSpecialObject(soDrucken) as AutoSpecialDrucken);
  try
    Group := Drucken.OpenLayoutGroup('Au','VogDrVorgang');
    Layout := Group.Item['(Rechnung I)'];
    tbl := BpApp.DataSetInfos['Vorgang'].CreateDataSet;
    tbl.First;
    // Hier muss der entsprechende Rechnungsdatensatz positioniert werden
    // WICHTIG: Stimmen Datensatzart und Druck nicht überein,
    // kann es zu Fehlern oder verfälschten Ausdrucken kommen.
    Layout.doPrintDirect(tbl, aDirect);
  finally
    tbl := nil;
    Layout := nil;
    Group := nil;
    Drucken := nil;
  end;
  Result := True;
end;

3.1.106.1 IAutoDrucken Eigenschaften

Methoden

Name	Beschreibung
OpenLayoutGroup	Erstellen eines AutoDruckenLayoutGroup Objektes.
PossibleLayoutGroup	Diese Funktion kann verwendet werden, um zu ermitteln, welche Drucke für eine bestimmte Tabelle verfügbar sind.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Parent	Gibt das Parent Interface zurück.

3.1.106.2 IAutoDrucken::OpenLayoutGroup Methode

Erstellen eines AutoDruckenLayoutGroup Objektes.

IDL

[id(0x000000C9)]
HRESULT _stdcall OpenLayoutGroup([in] BSTR aModul, [in] BSTR aGroup, [out, retval]
AutoDruckenLayoutGroup** Result);

Beschreibung

Wenn OpenLayoutGroup ausgeführt wird, findet eine Prüfung auf eine Remote-Desktop Lizenz statt. Ist kein namensgebundener Remote-Desktop-Schlüssel vorhanden oder sind alle Remoteverbindungen aufgebraucht, wird eine Exception generiert. "Fehler im SpecialObject Drucken: "Benutzer XYZ" konnte kein Objekt erstellen. Remote-Desktop Lizenz nicht vorhanden oder nicht genügend Lizenzen vorhanden" ist die dabei erstellte Meldung. Ist eine Remotelizenz vorhanden, aber ist diese nicht endgültig, kann die benötigte Druckgenerator-Dll nicht eingeladen werden.

Parameter

Parameter	Beschreibung
[in] BSTR aModul	Modulkürzel (z. B. `'Au'` für Ausgangsrechnung)
[in] BSTR aGroup	Druckgruppenname (z. B. `'VogDrVorgang'`)
[out, retval] AutoDruckenLayoutGroup** Result	Gibt ein AutoDruckenLayoutGroup Interface zurück

3.1.106.3 IAutoDrucken::PossibleLayoutGroup Methode

Diese Funktion kann verwendet werden, um zu ermitteln, welche Drucke für eine bestimmte Tabelle verfügbar sind.

IDL

[id(0x000000CA)]
HRESULT _stdcall PossibleLayoutGroup([in] BSTR aTableName, [out, retval]
AutoDruckenLayoutGroup** Result);

Beschreibung

PossibleLayoutGroup liefert eine Layoutgruppe zurück, die alle für die angegebene Tabelle verfügbaren Drucklayouts enthält.

Parameter

Parameter	Beschreibung
[in] BSTR aTableName	Name der Tabelle, für die die Drucklayouts ermittelt werden sollen
[out, retval] AutoDruckenLayoutGroup** Result	Gibt ein AutoDruckenLayoutGroup Interface zurück

3.1.107 IAutoDruckenLayoutGroup Interface

Die Layoutgruppe beinhaltet alle Layouts, die in dem angegebenen Bereich verfügbar sind.

IDL

[ uuid(9E313791-A32F-4063-8671-B6CCF414E0EB), version(1.0), dual, oleautomation ]
interface IAutoDruckenLayoutGroup : IAutoBase;

3.1.107.1 IAutoDruckenLayoutGroup Eigenschaften

Methoden

Name	Beschreibung
_NewEnum	Standard-Enumerator für For-Each-Schleifen.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Count	Anzahl der Elemente in dieser Gruppe.
Item	Zugriff auf ein bestimmtes Layout über Index oder Name.
Parent	Gibt das Parent Interface zurück.

3.1.107.2 IAutoDruckenLayoutGroup::Count Eigenschaft

Anzahl der Layouts in dieser Gruppe.

IDL

__property long* Count;

3.1.107.3 IAutoDruckenLayoutGroup::Item Eigenschaft

Zugriff auf ein bestimmtes Layout.

IDL

__property AutoDruckLayout** Item;

Beschreibung

Gibt ein AutoDruckLayout Interface für das über Index oder Name angegebene Layout zurück.

3.1.107.4 IAutoDruckenLayoutGroup::_NewEnum Methode

Standard-Enumerator.

IDL

[id(0xFFFFFFFC)]
HRESULT _stdcall _NewEnum([out, retval] IUnknown** Result);

3.1.108 IAutoDruckLayout Interface

SpecialObject für das Drucken.

IDL

[ uuid(D0AC24F3-B0BA-4D3E-9CA8-22F15FA1E1DD), version(1.0), dual, oleautomation ]
interface IAutoDruckLayout : IAutoBase;

Beschreibung

Ab Build: 3855.

3.1.108.1 IAutoDruckLayout Eigenschaften

Methoden

Name	Beschreibung
Delete	Löscht das aktuelle Layout.
doPrintDirect	Stößt einen Druck des aktuell gewählten Layouts an.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Name	Gibt den Namen des aktuellen Layouts aus.
Parent	Gibt das Parent Interface zurück.

3.1.108.2 IAutoDruckLayout::Delete Methode

Löscht das aktuelle Layout.

IDL

[id(0x000000CB)]
HRESULT _stdcall Delete();

3.1.108.3 IAutoDruckLayout::Name Eigenschaft

Gibt den Namen des aktuellen Layouts aus.

IDL

__property BSTR* Name;

Beschreibung

Gibt den Anzeigenamen des Layouts aus. Dieser Wert entspricht der Anzeige, die auch in der Druckauswahl zu sehen ist.

3.1.108.4 IAutoDruckLayout::doPrintDirect Methode

Stößt einen Druck des aktuell gewählten Layouts an.

IDL

[id(0x000000CC)]
HRESULT _stdcall doPrintDirect([in] AutoDataSet* aAutoDataSet, [in] VARIANT_BOOL aDirect);

Beschreibung

Dieser Aufruf druckt das gewählte Layout mit der angegebenen Tabelle aus. Stimmen Datensatz oder Tabelle nicht mit dem ausgewählten Druck überein, kann es zu schweren Fehlern oder Fehldrucken kommen.

Ausnahme sind Drucke wie z. B. die Chefauswertungen. Da diese fest definiert sind und auch über kein Wechsel der Sortierung oder über Range-Möglichkeiten verfügen, genügt es hier einfach eine beliebige Tabelle per AutoDataSet zu übergeben.

Wenn für den Druck keine Daten zur Verfügung stehen, wird eine Exception „Es stehen keine Datensätze für diesen Druck zur Verfügung." ausgegeben.

Anmerkungen

Um Problemen die bei gleichzeitiger Nutzung der Druckausgabe auftreten zu begegnen wurde ab Build 5034 für doPrintDirect und doFaxDirect eine intern eingebaute Serialisierung eingeführt. Pro Computer kann immer nur ein Thread in doPrintDirect oder in doFaxDirect sein. Weitere Aufrufe werden angenommen und versuchen so oft wie RequestRetryCount gesetzt ist für eine Wartezeit von RequestTimeOut einen Druckslot zu erhalten. Gelingt es nicht innerhalb der Wartezeit den Druck zu starten wird eine OleException ausgelöst. Die Exception können Sie verwenden, um die Ausgabe noch einmal einzuleiten.

Parameter

Parameter	Beschreibung
[in] AutoDataSet* aAutoDataSet	In Parameter einer Tabelle, die den zu druckenden Datensatz beinhaltet. Die geöffnete Tabelle muss mit dem gewählten Druck übereinstimmen. Ausnahme sind Drucke wie z.b. die Chefauswertung. Da diese fest definiert, genügt es hier einfach eine beliebige Tabelle zu übergeben
[in] VARIANT_BOOL aDirect	Wenn dieser Parameter "True" ist, wird, wenn möglich ohne Benutzerinteraktion ein Druck angestoßen

3.1.109 IAutoDruckLayout2 Interface

Von AutoDruckLayout abgeleitetes Interface.

IDL

[ uuid(198E3253-FE95-483A-AD64-9310FC2635F7), version(1.0), dual, oleautomation ]
interface IAutoDruckLayout2 : IAutoDruckLayout;

Beschreibung

Ab Build: 3855.

3.1.109.1 IAutoDruckLayout2 Eigenschaften

Alle Methoden/Eigenschaften aus IAutoDruckLayout

Methoden

Name	Beschreibung
Delete	Löscht das aktuelle Layout.
doPrintDirect	Stößt einen Druck des aktuell gewählten Layouts an.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Name	Gibt den Namen des aktuellen Layouts aus.
Parent	Gibt das Parent Interface zurück.
PrintingHWND	Gibt das Windowshandle für das Elternfenster des Druckvorgangs zurück.

3.1.109.2 IAutoDruckLayout2::PrintingHWND Eigenschaft

Gibt das Windowshandle für das Elternfenster des Druckvorgangs zurück.

IDL

__property unsigned long* PrintingHWND;

Beschreibung

Gibt ein HWND des Hauptfensters vom Druck zurück.

3.1.110 IAutoDruckLayout3 Interface

Von AutoDruckLayout2 abgeleitetes Interface.

IDL

[ uuid(42ABAED9-E0F0-4C1E-B50E-2871905BD323), version(1.0), dual, oleautomation ]
interface IAutoDruckLayout3 : IAutoDruckLayout2;

Beschreibung

Ab Build: 3855.

3.1.110.1 IAutoDruckLayout3 Eigenschaften

Alle Methoden/Eigenschaften aus IAutoDruckLayout2

Methoden

Name	Beschreibung
Delete	Löscht das aktuelle Layout.
doFaxDirect	Diese Funktion veranlasst eine Faxausgabe des gewählten Layouts.
doPrintDirect	Stößt einen Druck des aktuell gewählten Layouts an.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Name	Gibt den Namen des aktuellen Layouts aus.
Parent	Gibt das Parent Interface zurück.
PrinterName	Dieser Wert steuert den verwendeten Drucker.
PrintingHWND	Gibt das Windowshandle für das Elternfenster des Druckvorgangs zurück.

3.1.110.2 IAutoDruckLayout3::doFaxDirect Methode

Diese Funktion veranlasst eine Faxausgabe des gewählten Layouts.

IDL

[id(0x00000191)]
HRESULT _stdcall doFaxDirect([in] AutoDataSet* aAutoDataSet, [in] VARIANT_BOOL aDirect);

Beschreibung

Dieser Aufruf faxt das gewählte Layout mit der angegebenen Tabelle.

Parameter

Parameter	Beschreibung
[in] AutoDataSet* aAutoDataSet	In Parameter einer Tabelle, die den zu druckenden Datensatz beinhaltet. Die geöffnete Tabelle muss mit dem gewählten Druck übereinstimmen
[in] VARIANT_BOOL aDirect	Wenn dieser Parameter "True" ist, wird wenn möglich ohne Benutzerinteraktion ein Fax erstellt

3.1.110.3 IAutoDruckLayout3::PrinterName Eigenschaft

Dieser Wert steuert den verwendeten Drucker.

IDL

__property BSTR PrinterName;

Beschreibung

Wenn dieser Wert mit einem String gesetzt wird, versucht der Druck diesen Drucker als Vorauswahl zu treffen.

Anmerkungen

Dieser Wert wird nur beachtet, wenn der Druck direkt ausgeführt wird. Wird das Fenster für die Druckerauswahl angezeigt, bleibt dieser Wert ohne Wirkung. Bitte beachten Sie, dass keine Gültigkeitsprüfung erfolgt, ob der Drucker vorhanden ist. Bevor Sie diesen Wert setzen, sollten Sie die gültigen Namen der Drucker abfragen.

Bei einer Faxausgabe (doFaxDirect) wird dieser Wert in keiner Weise beachtet.

3.1.111 IAutoDruckLayout4 Interface

Von AutoDruckLayout3 abgeleitetes Interface.

IDL

[ uuid(163A2357-DFEB-488E-989B-68E3254F9B7E), version(1.0), dual, oleautomation ]
interface IAutoDruckLayout4 : IAutoDruckLayout3;

Beschreibung

Ab Build: 5000.

Beispiel (Delphi) - Drucken, Export und Formate auslesen

/// Druck Objecte erzeugen ///
  DataSet := BpApp.DataSetInfos['Vorgang'].CreateDataSet;
  DataSet.First;
  Drucken := BpApp.GetSpecialObject(soDrucken);
  Gruppe := Drucken.OpenLayoutGroup('Au', 'VogDrVorgang');
  Layout := Gruppe.Item('(Rechnung I)');

/// Drucken ///
  ShowMessage(IntToStr(Layout.Printer.PrinterCount));
  Layout.Printer.PrinterKind := 1; //Erste/Folge Seiten
  ShowMessage(IntToStr(Layout.Printer.PrinterCount));
  Showmessage(
    Layout.Printer.PrinterEntrys[0].DeviceName + #13#10 +
    Layout.Printer.PrinterEntrys[1].DeviceName + #13#10 +
    Layout.Printer.PrinterEntrys[2].DeviceName
  );
  Layout.Printer.PrinterEntrys[0].DeviceName := 'Mein Druckername1';
  Layout.Printer.PrinterEntrys[1].DeviceName := 'Mein Druckername2';
  Layout.Printer.Save;
  Showmessage(
    Layout.Printer.PrinterEntrys[0].DeviceName + #13#10 +
    Layout.Printer.PrinterEntrys[1].DeviceName + #13#10 +
    Layout.Printer.PrinterEntrys[2].DeviceName
  );
  Layout.doPrintDirect(DataSet, true);

/// Export ///
  Layout.Printer.FileExport := true;
  Layout.Printer.FileOverwrite := true;
  showmessage(Layout.Printer.FileName);
  Layout.Printer.FileFormat := 0;
  Layout.Printer.FileName := 'C:\Tmp\Testexport.ll';
  Layout.Printer.Save;
  Layout.doPrintDirect(DataSet, true);

/// mögliche Export Formate auslesen ///
  Buffer := '';
  try
    for I := 0 to 100 do
    begin
      Layout.Printer.FileFormat := i;
      Buffer := Buffer + ' - ' + Layout.Printer.FileFormatName + ' ('+ IntToStr(i) +')';
    end;
  except // Fehler bei Überschreitung der Formate schlucken
  end;
  Showmessage(Buffer);

3.1.111.1 IAutoDruckLayout4 Eigenschaften

Alle Methoden/Eigenschaften aus IAutoDruckLayout3

Methoden

Name	Beschreibung
Delete	Löscht das aktuelle Layout.
doFaxDirect	Diese Funktion veranlasst eine Faxausgabe des gewählten Layouts.
doPrintDirect	Stößt einen Druck des aktuell gewählten Layouts an.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Name	Gibt den Namen des aktuellen Layouts aus.
Parent	Gibt das Parent Interface zurück.
Printer	Einstellungsobjekt für Druckerauswahl beim Druck über COM.
PrinterName	Dieser Wert steuert den verwendeten Drucker.
PrintingHWND	Gibt das Windowshandle für das Elternfenster des Druckvorgangs zurück.

3.1.111.2 IAutoDruckLayout4::Printer Eigenschaft

Einstellungsobjekt für Druckerauswahl beim Druck über COM.

IDL

__property AutoSpecialDruckOptions** Printer;

Beschreibung

Über die Eigenschaft "Printer" kann man ab Build 5000 auf viele Druckereinstellungen der Ausdrucke zugreifen. Vor allem für Drucke aus einem Windows Dienst heraus ist die Möglichkeit fast alle Einstellungen vorzunehmen interessant.

Parameter

Parameter	Beschreibung
Value	Gibt das Interface für AutoSpecialDruckOptions zurück

3.1.112 IAutoSpecialDruckOptions Interface

Dieses Interface kann beim Drucken unter COM auf die Eigenschaften der Druckerauswahl zugreifen.

IDL

[ uuid(6F45D7CE-E725-44FF-B0F7-CE0114C3F81D), version(1.0), dual, oleautomation ]
interface IAutoSpecialDruckOptions : IAutoBase;

3.1.112.1 IAutoSpecialDruckOptions Eigenschaften

Methoden

Name	Beschreibung
AreaCount	AreaCount gibt die Anzahl der Druckbereiche in dem aktuellen Drucklayout zurück.
AreaEntrys	AreaEntrys gibt das Interface für einen bestimmten Druckbereich zurück.
Save	Speichert Druck-Optionen.

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
FileExport	FileExport legt fest, ob ein Export erfolgen soll.
FileFormat	FileFormat bestimmt bei einem Export das Dateiformat.
FileFormatName	FileFormatName enthält den Dateinamen.
FileName	Dateiname für Export.
FileOverwrite	Bestimmt, ob beim Export die Datei überschrieben wird.
Parent	Gibt das Parent Interface zurück.
PrintKind	Enum, der die Druckausgabe bestimmt. (Eine Seite; Erste/Folgeseiten; Freie Eingabe).

3.1.112.2 IAutoSpecialDruckOptions::Save Methode

Speichert Druck-Optionen.

IDL

[id(0x0000012D)]
HRESULT _stdcall Save();

Beschreibung

Save speichert die aktuellen Druckereinstellungen. Die so gespeicherte Einstellung ist persistent. Je nachdem wie Ihre Druckereinstellungen gespeichert werden und je nachdem wer der Windowsbenutzer ist können sie so z.B. "normalen" Benutzern die Druckereinstellungen umstellen.

3.1.112.3 IAutoSpecialDruckOptions::AreaCount Methode

AreaCount gibt die Anzahl der Druckbereiche in dem aktuellen Drucklayout zurück.

IDL

[id(0x0000012E)]
HRESULT _stdcall AreaCount([out, retval] long* Result);

Beschreibung

Anzahl der Druckbereiche.

Parameter

Parameter	Beschreibung
[out, retval] long* Result	Integer mit der Anzahl der Druckereinstellungen in diesem Layout

3.1.112.4 IAutoSpecialDruckOptions::AreaEntrys Methode

AreaEntrys gibt das Interface für einen bestimmten Druckbereich zurück.

IDL

[propget, id(0x0000012F)]
HRESULT _stdcall AreaEntrys([in] long Index, [out, retval] AutoSpecialPrinterArea** Value);

Beschreibung

Mit AreaEntry können sie die einzelnen Druckbereiche erhalten und deren Eigenschaften anpassen.

Parameter

Parameter	Beschreibung
[in] long Index	Integer Position des Druckbereichs
[out, retval] AutoSpecialPrinterArea** Value	AutoSpecialPrinterArea Dieses Interface entspricht dem Druckbereich an der in Index übergebenen Stelle

3.1.112.5 IAutoSpecialDruckOptions::PrintKind Eigenschaft

Enum, der die Druckausgabe bestimmt. (Eine Seite; Erste/Folgeseiten; Freie Eingabe).

IDL

__property enum PrintKind PrintKind;

Beschreibung

Enum, der die Druckart bestimmt.

3.1.112.6 IAutoSpecialDruckOptions::FileName Eigenschaft

Dateiname für Export.

IDL

__property BSTR FileName;

Beschreibung

FileName wird beim Exportieren genutzt. Das ist der Zielname der zu exportierenden Datei.

Anmerkungen

Bitte bedenken Sie, dass einzelne Export-Formate mehr als eine Datei erstellen oder diese Datei schon vorhanden sein kann. In diesem Fall ist der Filename nur der Basisname von dem ausgehend ein gültiger Dateiname gebildet wird.

3.1.112.7 IAutoSpecialDruckOptions::FileOverwrite Eigenschaft

Bestimmt, ob beim Export die Datei überschrieben wird.

IDL

__property VARIANT_BOOL FileOverwrite;

Beschreibung

Ist FileOverwrite "True", wird beim Export eine eventuell schon vorhandene Datei überschrieben.

3.1.112.8 IAutoSpecialDruckOptions::FileFormat Eigenschaft

FileFormat bestimmt bei einem Export das Dateiformat.

IDL

__property long FileFormat;

Beschreibung

FileFormat bestimmt für einen Export das Format, in dem exportiert wird.

Aktuell definierte Formate (Stand 26.08.2016):

Format	Integer	Beschreibung
LL	0	List & Label Format
XLS	1	Excel
PDF	2	Adobe Portable Document Format
RTF	3	Rich Text Format
HTML	4	Hypertext Markup Language
MHTML	5	Mimetype Hypertext Markup Language
XML	6	Extendable Markup Language
JPG	7	JPG Bildformat (kann mehrere Dateien erstellen)
BMP	8	BMP Bildformat (kann mehrere Dateien erstellen)
EMF	9	EMF Bildformat (kann mehrere Dateien erstellen)
TIFF	10	TIFF Bildformat (kann mehrere Dateien erstellen)
MultiTIFF	11	Multipage TIFF Bildformat
TXT	12	Text basierter Export
XPS	13	XML Paper Specification
JPG (über microtech Software)	14	JPG Bildformat (kann mehrere Dateien erstellen)
EMF (über microtech Software)	15	EMF Bildformat (kann mehrere Dateien erstellen)
PDF (über microtech Software)	16	Adobe Portable Document Format über microtech Software
obsolete: XLSData	17	Excel Ausgabe ohne Formatierung. (Diese Optionen können auch direkt im Layout gesteuert werden.)
obsolete: XLSKopfFussData	18	Excel Ausgabe ohne Formatierung aber mit Kopf und Fuß Daten. (Diese Optionen können auch direkt im Layout gesteuert werden.)
XLSX	19	Excel im neuen Format
Word	20	Word Dokument
PowerPoint	21	PowerPoint Präsentation
SVG	22	Scalable Vector Graphics Format
None	23	/

Anmerkungen

Bitte beachten Sie, dass je nach Ausbaustufe und Programmversion der microtech Software die zur Verfügung stehenden Formate unterschiedlich sein können. Zusätzlich können Benutzern die Rechte fehlen um ein vorhandenes Format zu benutzen.

Beispiel (Delphi) - Exportformate auslesen

/// Druck Objecte erzeugen ///
  DataSet := BpApp.DataSetInfos['Vorgang'].CreateDataSet;
  DataSet.First;
  Drucken := BpApp.GetSpecialObject(soDrucken);
  Gruppe := Drucken.OpenLayoutGroup('Au', 'VogDrVorgang');
  Layout := Gruppe.Item('(Rechnung I)');

/// mögliche Export Formate auslesen ///
  Buffer := '';
  try
    for I := 0 to 100 do
    begin
      Layout.Printer.FileFormat := i;
      Buffer := Buffer + ' - ' + Layout.Printer.FileFormatName + ' ('+ IntToStr(i) +')';
    end;
  except // Fehler bei Überschreitung der Anzahl der Formate unterdrücken
  end;
  Showmessage(Buffer);

3.1.112.9 IAutoSpecialDruckOptions::FileExport Eigenschaft

FileExport legt fest, ob ein Export erfolgen soll.

IDL

__property VARIANT_BOOL FileExport;

Beschreibung

Ist FileExport "True", wird beim Execute ein Export angestoßen. "False" führt einen Druck aus.

3.1.112.10 IAutoSpecialDruckOptions::FileFormatName Eigenschaft

FileFormatName enthält den Dateinamen.

IDL

__property BSTR* FileFormatName;

Beschreibung

Wenn ein Export erfolgt, kann mit dieser Eigenschaft der Dateiname festgelegt werden.

3.1.113 IAutoSpecialPrinterArea Interface

BpNT::IAutoSpecialPrinterArea stellt die Eigenschaften eines Druckbereiches bereit.

IDL

[ uuid(A161FFD0-B7F5-4343-A0D2-B34A57F88336), version(1.0), dual, oleautomation ]
interface IAutoSpecialPrinterArea : IAutoBase;

Beschreibung

Das Interface BpNT::IAutoSpecialPrinterArea kann auf die einzelnen Eigenschaften eines Druckbereiches zugreifen.

Viele der hier aufgezeigten Eigenschaften sind teilweise identisch mit den Steuerungsoptionen die Windows im DEVMODE deklariert. In der MSDN sind diese Informationen unter DEVMODE structure zu finden.

3.1.113.1 IAutoSpecialPrinterArea Eigenschaften

Eigenschaften

Name	Beschreibung
Application	Zugriff auf das Basisobjekt, von dem alle Interfaces abstammen.
Collate	Collate bestimmt die Sortierreihenfolge beim Druck.
Condition	Condition ist die Formel für den Druckbereich.
Copies	Copies bestimmt die Anzahl der Kopien.
DeviceDevMode	DeviceDevMode
DeviceExtraData	DeviceExtraData
DeviceName	DeviceName
Duplex	Duplex bestimmt, ob die Ausgabe in Duplex erfolgt.
FitPage	FitPage Anpassung an Druckgröße.
ForcePaperFormat	ForcePaperFormat erzwingt ein Ausgabeformat.
LayoutPrintOrder	LayoutPrintOrder
LayoutXCount	LayoutXCount
LayoutXDistance	LayoutXDistance
LayoutXOffset	LayoutXOffset
LayoutXSize	LayoutXSize
LayoutYCount	LayoutYCount
LayoutYDistance	LayoutYDistance
LayoutYOffset	LayoutYOffset
LayoutYSize	LayoutYSize
Name	Name gibt den Namen des Druckbereichs an.
PaperExtendHorizontal	PaperExtendHorizontal
PaperExtendVertical	PaperExtendVertical
PaperFormat	PaperFormat
PaperOrientation	PaperOrientation
PaperPrintableAreaExtentHorizontal	PaperPrintableAreaExtentHorizontal
PaperPrintableAreaExtentVertical	PaperPrintableAreaExtentVertical
PaperPrintableAreaOffsetHorizontal	PaperPrintableAreaOffsetHorizontal
PaperPrintableAreaOffsetVertical	PaperPrintableAreaOffsetVertical
Parent	Gibt das Parent Interface zurück.
ShowInPrintDialog	ShowInPrintDialog
SourceTray	SourceTray ist die Identifizierungsnummer der Schachtsteuerung.
UsePhysicalPaper	UsePhysicalPaper

3.1.113.2 IAutoSpecialPrinterArea::Collate Eigenschaft

Collate bestimmt die Sortierreihenfolge beim Druck.

IDL

__property BSTR Collate;

Beschreibung

Collate bestimmt die Sortierung beim Druck. Diese Option kann erst bei mehr als einer Kopie der Ausgabe Wirkung zeigen.

Mögliche Werte sind 0 und 1.

3.1.113.3 IAutoSpecialPrinterArea::Condition Eigenschaft

Condition ist die Formel für den Druckbereich.

IDL

__property BSTR Condition;

Beschreibung

Diese Formel wird während der Ausgabe des Druckes verwendet um zu bestimmen welche der Druckebenen verwendet werden soll. Es wird die erste Ebene verwendet, die in diesem Ausdruck ein "True" liefert.

3.1.113.4 IAutoSpecialPrinterArea::Copies Eigenschaft

Copies bestimmt die Anzahl der Kopien.

IDL

__property BSTR Copies;

Beschreibung

Es wird die Anzahl der Kopien angegeben. Es können nur ganzzahlige Werte verwendet werden.

3.1.113.5 IAutoSpecialPrinterArea::Duplex Eigenschaft

Duplex bestimmt, ob die Ausgabe in Duplex erfolgt.

IDL

__property BSTR Duplex;

Beschreibung

Dieser Wert bestimmt, ob der Ausdruck durch den Druckertreiber als Duplexdruck zu interpretieren ist. Mögliche Werte sind 0 und 1.

3.1.113.6 IAutoSpecialPrinterArea::FitPage Eigenschaft

FitPage Anpassung an Druckgröße.

IDL

__property BSTR FitPage;

Beschreibung

Dieser Wert bestimmt, ob der Ausdruck auf den Druckbereich eingepasst werden soll.

Mögliche Werte sind 0 und 1.

3.1.113.7 IAutoSpecialPrinterArea::ForcePaperFormat Eigenschaft

ForcePaperFormat erzwingt ein Ausgabeformat.

IDL

__property BSTR ForcePaperFormat;

Beschreibung

Wenn Ihre Bereiche auf einem Format stehen, dass vom Drucker nicht abgebildet werden kann, ist es in einigen Fällen möglich diese Ausgabe hier zu erzwingen.

Mögliche Werte sind "True" und "False".

3.1.113.8 IAutoSpecialPrinterArea::Name Eigenschaft

Name gibt den Namen des Druckbereichs an.

IDL

__property BSTR Name;

Beschreibung

Dieser Name ist die Bezeichnung, die im Druckdesigner und bei der Druckerauswahl in microtech Software sichtbar ist.

3.1.113.9 IAutoSpecialPrinterArea::SourceTray Eigenschaft

SourceTray ist die Identifizierungsnummer der Schachtsteuerung.

IDL

__property BSTR SourceTray;

Beschreibung

Wenn der verwendete Drucker eine Schachtsteuerung unterstützt, können Sie hier die Nummer für den gewünschten Schacht lesen und schreiben. In der Regel ist der Wert numerisch.

3.1.113.10 IAutoSpecialPrinterArea::UsePhysicalPaper Eigenschaft

UsePhysicalPaper

IDL

__property BSTR UsePhysicalPaper;

Beschreibung

Dieser Wert definiert, ob der Druck mit oder ohne den Randinformationen des gewählten Druckers erfolgen soll. In der Regel muss dieser Wert nicht angepasst werden.

Mögliche Werte sind "True" und "False".

3.1.113.11 IAutoSpecialPrinterArea::ShowInPrintDialog Eigenschaft

ShowInPrintDialog

IDL

__property BSTR ShowInPrintDialog;

Beschreibung

Dieser Wert definiert, ob der Druckbereich in der Druckerauswahl in microtech Software erscheinen soll. Dieser Wert muss in der Regel nicht geändert werden, wenn doch, ist der Druckdesigner dafür die richtige Stelle.

Mögliche Werte sind "True" und "False".

3.1.113.12 IAutoSpecialPrinterArea::DeviceName Eigenschaft

DeviceName

IDL

__property BSTR DeviceName;

Beschreibung

Hier kann der Druckername angegeben werden.

3.1.113.13 IAutoSpecialPrinterArea::DeviceDevMode Eigenschaft

DeviceDevMode

IDL

__property BSTR DeviceDevMode;

Beschreibung

Encodierter String mit dem binären Inhalt des Devmodes.

3.1.113.14 IAutoSpecialPrinterArea::DeviceExtraData Eigenschaft

DeviceExtraData

IDL

__property BSTR DeviceExtraData;

Beschreibung

Druckertreiber-eigene Daten. Bei vielen Treibern ist dieser Wert leer.

3.1.113.15 IAutoSpecialPrinterArea::PaperFormat Eigenschaft

PaperFormat

IDL

__property BSTR PaperFormat;

Beschreibung

Papierformat. Die möglichen Werte sind ebenfalls in der DEVMODE Auflistung bei Microsoft dokumentiert.

3.1.113.16 IAutoSpecialPrinterArea::PaperOrientation Eigenschaft

PaperOrientation

IDL

__property BSTR PaperOrientation;

Beschreibung

Ausrichtung des Papiers. "0" und "1" sind erlaubt.

3.1.113.17 IAutoSpecialPrinterArea::PaperExtendHorizontal Eigenschaft

PaperExtendHorizontal

IDL

__property BSTR PaperExtendHorizontal;

Beschreibung

Horizontale Papiergröße.

3.1.113.18 IAutoSpecialPrinterArea::PaperExtendVertical Eigenschaft

PaperExtendVertical

IDL

__property BSTR PaperExtendVertical;

Beschreibung

Vertikale Papiergröße.

3.1.113.19 IAutoSpecialPrinterArea::PaperPrintableAreaExtentHorizontal Eigenschaft

PaperPrintableAreaExtentHorizontal

IDL

__property BSTR PaperPrintableAreaExtentHorizontal;

Beschreibung

Druck Bereich Horizontal.

3.1.113.20 IAutoSpecialPrinterArea::PaperPrintableAreaExtentVertical Eigenschaft

PaperPrintableAreaExtentVertical

IDL

__property BSTR PaperPrintableAreaExtentVertical;

Beschreibung

Druck Bereich Vertikal.

3.1.113.21 IAutoSpecialPrinterArea::PaperPrintableAreaOffsetHorizontal Eigenschaft

PaperPrintableAreaOffsetHorizontal

IDL

__property BSTR PaperPrintableAreaOffsetHorizontal;

Beschreibung

Druck Bereich Verschiebung Horizontal.

3.1.113.22 IAutoSpecialPrinterArea::PaperPrintableAreaOffsetVertical Eigenschaft

PaperPrintableAreaOffsetVertical

IDL

__property BSTR PaperPrintableAreaOffsetVertical;

Beschreibung

Druck Bereich Verschiebung Vertikal.

3.1.113.23 IAutoSpecialPrinterArea::LayoutPrintOrder Eigenschaft

LayoutPrintOrder

IDL

__property BSTR LayoutPrintOrder;

Beschreibung

Reihenfolge des Ausdrucks. Nur relevant bei Kopien. Da microtech Software die Ausgabe aber selbst erledigt, ist dieser Wert wirkungslos.

3.1.113.24 IAutoSpecialPrinterArea::LayoutXCount Eigenschaft

LayoutXCount

IDL

__property BSTR LayoutXCount;

Beschreibung

Nur bei Labeln: Anzahl der Labels auf der X-Achse.

3.1.113.25 IAutoSpecialPrinterArea::LayoutXDistance Eigenschaft

LayoutXDistance

IDL

__property BSTR LayoutXDistance;

Beschreibung

Nur bei Labeln: Entfernung der Label auf der X-Achse.

3.1.113.26 IAutoSpecialPrinterArea::LayoutXOffset Eigenschaft

LayoutXOffset

IDL

__property BSTR LayoutXOffset;

Beschreibung

Nur bei Labeln: Offset des ersten Labels auf der X-Achse (ausgehend vom Drucker-Rand).

3.1.113.27 IAutoSpecialPrinterArea::LayoutXSize Eigenschaft

LayoutXSize

IDL

__property BSTR LayoutXSize;

Beschreibung

Nur bei Labeln: Gesamtbreite des Labels auf der X-Achse.

3.1.113.28 IAutoSpecialPrinterArea::LayoutYCount Eigenschaft

LayoutYCount

IDL

__property BSTR LayoutYCount;

Beschreibung

Nur bei Labeln: Anzahl der Labels auf der Y-Achse.

3.1.113.29 IAutoSpecialPrinterArea::LayoutYDistance Eigenschaft

LayoutYDistance

IDL

__property BSTR LayoutYDistance;

Beschreibung

Nur bei Labeln: Entfernung der Label auf der Y-Achse.

3.1.113.30 IAutoSpecialPrinterArea::LayoutYOffset Eigenschaft

LayoutYOffset

IDL

__property BSTR LayoutYOffset;

Beschreibung

Nur bei Labeln: Offset des ersten Labels auf der Y-Achse (ausgehend vom Drucker-Rand).

3.1.113.31 IAutoSpecialPrinterArea::LayoutYSize Eigenschaft

LayoutYSize

IDL

__property BSTR LayoutYSize;

Beschreibung

Nur bei Labeln: Gesamtbreite des Labels auf der Y-Achse.