Herd Software Entwicklung
DaVinci Grafikbibliothek
DaVinci Dokumentation
Herd Software Entwicklung
DaVinci Grafikbibliothek
DaVinci Dokumentation
Die ipExportExt-Funktion benutzt folgende Aufrufsyntax
IPERROR FAR PASCAL ipExportExt(
LPSTR pszName,
DWORD dwFlags,
FARPROC fnBck,
DWORD FileTyp,
HWND hWnd,
LPPOINT pnSize,
HDIB hdib,
HMETAFILE hmf
LPMETARESOLUTION lpmr,
DWORD dummy);
pszName Dateiname. Darf NULL sein. Wenn nicht NULL und IPF_FILEDIALOG, wird der Name der tatsächlich importierten Datei hier abgelegt. Falls pszName angegeben ist, wird es als Anfangswert für das Dateinamen-Dialogfenster eingesetzt, pszName muß daher immer auf einen gültigen Dateinamen-String mit < 100 Zeichen zeigen. Falls pszName NULL ist oder auf einen leeren String zeigt, setzt DaVinci einen String mit der Liste gültiger Extensions zusammen : *.BMP;*.TIF;*.WMF..
dwFlags Eine Kombination von Flags aus der IPF_xxxxx - Reihe, jeweils mit dem Oder-Operator | verknüpft:
fnBck Adresse einer CallBack-Prozedur, die während der Umwandlung von Zeit zu Zeit aufgerufen werden soll. Mit dieser Callback-Prozedur kann die Anwendung das Multitasking weiterlaufen lassen. Da DaVinci nicht reenterant ist, wird eine Fehlermeldung produziert, wenn DaVinci eine weitere Umwandlung starten soll. Die Callback-Funktion kann als Rückgabewert FALSE liefern, um die Umwandlung abzubrechen. Falls für fnBck NULL angegeben wird, prüft DaVinci lediglich die Esc-Taste und bricht ab, wenn diese gedrückt wurde. Das Windows-Multitasking wird nicht unterstützt. Für 16-Bit Anwendungen muß fnBck mit MakeProcInstance exportiert sein!
hWnd Handle des Elternfensters. Wird für die Dateidialoge eingesetzt. Ich empfehle dringend, dieses Element immer auszufüllen,
FileTyp Dateityp-Angabe, falls in dwFlags nicht IPF_FILEDIALOG angegeben wurde.
Normalerweise sollte IPF_FILEDIALOG mit IPT_SELECT kombiniert angegeben werden.
pnSize Zeiger auf eine POINT-Struktur mit der Auflösungsangabe einer Speicherbitmap, wenn ein Metafile in eine DIB konvertiert werden muß. NULL, falls Konvertierung nicht erwünscht ist (Dann werden die entsprechenden Dateiformate nicht unterstützt).
hdib Handle der auszugebenden DIB oder NULL
hmf Handle des auszugebenden Metafiles oder NULL
lpmr Zeiger auf eine METARESOLUTION-Struktur mit Angaben zur Auflösung (Größe in Millimetern und Seitenverhältnis) der MetaFile-Datei.
lParam Anwendungsdefinierter 32-Bit Wert der an die Callback-Funktion in fnBck weitergegeben wird.
Der Rückgabewert ist 0, wenn kein Fehler auftrat, oder es ist einer der IPE_xxxx Fehlercodes.
Diese Funktion unterstützt Entwickler bei der Umstellung von DaVinci Version 2.x auf Version 3.x. Neuentwickelte Anwendungen werden in der Regel die Funktion ipExportInd benutzen.