FileName (Eigenschaft)

In dieser Eigenschaft kann eine externe Datei, ein binäres Objekt oder ein importiertes Bild angegeben werden. Ist die Angabe einer externen Datei möglich, erscheint eine ComboBox, sobald der Fokus in die Eigenschaft gesetzt wird. Wird der Eintrag "Externe Datei..." ausgewählt, kann in einem anschließenden Dateiauswahl-Dialog die Datei gewählt werden.

Bei der Angabe einer externen Datei muss der Präfix '!' oder '*' angegeben werden, um einen relativen oder absoluten Pfad anzuzeigen. Binäre Objekte werden mit dem Präfix '>' gefolgt von der Nummer der verbundenen Datenbank, gekennzeichnet. Mit '>0' wird ein binäres Objekt aus der aktuellen Datenbank geladen. Ist kein Präfix angegeben, wird ein importiertes Bild geladen.

Je nach Objekt hat die Eigenschaft folgende Bedeutung:

• Animation

  Angabe einer externen Datei.

• CtxAdobeReader und CtxOffice

  In der Eigenschaft wird die externe Datei angegeben, die in dem Objekt angezeigt werden soll.

  Soll im CtxOffice-Objekt ein neues Dokument angelegt werden, kann das Dokument in der ComboBox ausgewählt werden. Folgende Dokumente können angegeben werden:

  • Wert der Eigenschaft: Anzeige in der ComboBox
  • '#Word.Document': Word-Dokument
  • '#Excel.Sheet': Excel-Sheet
  • '#Excel.Chart': Excel-Diagramm
  • '#PowerPoint.Show': PowerPoint-Präsentation
  • '#MSProject.Project': Project-Projekt
  • '#Visio.Drawing': Visio-Zeichnung
  • '#MapPoint.Map': MapPoint-Karte

• Icon

  Angabe einer externen oder in die Datenbank importierten Datei. Bei Angabe des Namens ohne Präfix ('!' und '*') wird eine Icon-Datei in der Datenbank referenziert.

• RtfEdit und PrtRtf

  Angabe einer externen oder in der Datenbank gespeicherten Datei. Die Quelle des Textes wird in der Eigenschaft StreamSource spezifiziert. Bei externen Dateien darf in der Eigenschaft dem Dateinamen kein '*' vorangestellt werden.

• DocView und PrtPdf

  Angabe einer externen Datei oder eines binären Objekts.

• PpcObject

  Dateiname des Druckjobs. Die Eigenschaft kann bei diesem Objekt nur gelesen werden.

• Systemdialog "Datei öffnen"

  FileName kann als Vorgabe und Resultat verwendet werden. In der Eigenschaft steht immer der Name einer externen Datei. Es darf kein Präfix angegeben werden. Bei Verwendung als Vorgabe wird die zu öffnende Datei im Dialog vorgeschlagen. Die vom Anwender geöffnete Datei wird über FileName ermittelt. Ist in der Eigenschaft Flags des Dialogs die Ausprägung _WinComAllowMultiSelect gesetzt, können mehrere Dateien ausgewählt werden. Auf die einzelnen Dateinamen kann dann über einen Index (zum Beispiel tFileName # tHdlDlg-> wpFileName (2)) zugegriffen werden. Die Anzahl der der selektierten Dateien befindet sich in der Eigenschaft FileCount. Über die Indexierung können nicht mehrere Vorgabedateien angegeben werden. Der Pfad kann über die Eigenschaft PathName ermittelt werden.

  info

  Bei Verwendung des alten Windows-Dialog Stiles (Ausprägung _WinComExplorer ist in der Eigenschaft Flags nicht gesetzt) werden Dateinamen vom Dialog in der Kurzform (8.3-Form; Leerzeichen ersetzt durch "~") angezeigt. Die Eigenschaft FileName gibt in jedem Fall die Langform des Dateinamens zurück.

• Systemdialog "Datei speichern"

  FileName kann als Vorgabe und Resultat verwendet werden. In der Eigenschaft steht immer der Name einer externen Datei. Es darf kein Präfix angegeben werden. Bei Verwendung als Vorgabe wird die zu speichernde Datei im Dialog vorgeschlagen. Die vom Anwender gespeicherte Datei wird über FileName ermittelt. Auch in diesem Dialog ist eine Mehrfachauswahl analog zum "Datei öffnen"-Dialog möglich. Der Pfad kann über die Eigenschaft PathName ermittelt werden.

  info

  Bei Verwendung des alten Windows-Dialog Stiles (Ausprägung _WinComExplorer ist in der Eigenschaft Flags nicht gesetzt) werden Dateinamen vom Dialog in der Kurzform (8.3-Form; Leerzeichen ersetzt durch "~") angezeigt. Die Eigenschaft FileName gibt in jedem Fall die Langform des Dateinamens zurück.

• (Sub-)Item eines RecView

  In (Sub-)Items eines RecView-Objektes kann je nach Wert der Eigenschaft ContentType ein Plain-, ein RTF-Text oder ein Bild angezeigt werden. Um den Inhalt aus BLObs zu lesen, muss '>0' vor den Dateinamen geschrieben werden. Soll eine externe Datei geladen werden muss '*' vor dem Pfad angegeben werden. Wurde kein Präfix verwendet, wird je nach ContentType der interne Text oder das importierte Bild verwendet.

• CtxDocEdit und CodeEdit

  Angabe einer externen oder in der Datenbank gespeicherten Datei. Bei Angabe des Namens ohne Präfix ('!' und '*') wird ein interner Text in der Datenbank referenziert.

Beispiele:

// externe Datei relativ angegeben
'!Icons\Artikel.ico'

// externe Datei absolut angegeben
'*C:\C16\Icons\Artikel.ico'

// Datei aus der Datenbank
'Artikel'

// Binäres Objekt aus der Datenbank (Darstellung im RtfEdit-, PrtRtf-, DocView und PrtDocView-Objekt)
'>0\Text\Artikel.rtf'