WklImage
Ein Bildsteuerelement für SVG und Bitmaps: Symbole und Zeichnungen in SVG bleiben in jeder Größe und im Druck scharf, einfarbige SVG-Symbole übernehmen eine Farbe des Formulars, und das Bild kann aus einer Datei, aus dem Bildkatalog der Datenbank, aus SVG-Text oder aus einem Feld stammen.
Erste Schritte
Keine
Häufige Aufgaben
Schaubild
+------------------------------+ | | | /\ | | / \ 1 | | /____\ | | 2 | +------------------------------+
| Bereich | Bedeutung |
|---|---|
| 1 | Das Bild von Source – oder von Value, wenn das Steuerelement gebunden und das Feld nicht Null ist –, platziert nach SizeMode: mit Seitenverhältnis gezoomt (Standardwert), gestreckt oder in natürlicher Größe. In SVG-Bildern übernimmt currentColor den Wert von SvgColor. |
| 2 | Der Hintergrund (BackColor), sichtbar, wo das Bild transparent ist oder nicht hinreicht. Lässt sich das Bild nicht anzeigen, steht der Grund hier und in ErrorText. |
Wichtige Funktionen
- SVG über Direct2D. Windows zeichnet das SVG (Windows 10 Version 1703 oder höher); kein Browser, kein Konverter. Pfade, Grundformen, Farbverläufe und Transformationen; Text und Filtereffekte von SVG werden nicht gezeichnet.
- Bitmaps und Metadateien. PNG, JPEG, BMP, GIF, ICO, EMF und WMF über GDI+.
- Vier Quellen. Eine Datei (relative Pfade beginnen beim Ordner der Datenbank), ein freigegebenes Bild der Datenbank über seinen Namen, SVG-Text oder ein Data-URI. URLs (
http:,https:) werden abgelehnt; ein Dateipfad darf auch eine Netzwerkfreigabe (UNC) nennen und wird wie eine lokale Datei gelesen. - Gebunden. Mit einem Steuerelementinhalt liefert das Feld je Datensatz den Quelltext oder die Bytes eines Bildes.
- Farbe von Symbolen.
SvgColorersetztcurrentColor, die Konvention von Symbolsätzen. - Fehler bleiben im Steuerelement. Eine fehlende Datei oder ein beschädigtes Bild zeigt den Grund statt eines Dialogs.
Grundkonzepte
Der Quelltext wird einmal eingeordnet (SVG-Text, Data-URI, Datei, freigegebenes Bild) und geladen, wenn das
Steuerelement das nächste Mal gezeichnet wird; so öffnet sich ein Formular, bevor Dateien gelesen werden, und ein
freigegebenes Bild lässt sich aus der Datenbank lesen, zu der das Steuerelement gehört. Bei SVG liest der Kern des
Frameworks die natürliche Größe aus width, height und viewBox, ergänzt eine viewBox, wo eine Datei nur eine
Größe hat, und setzt die Regel für das Seitenverhältnis des Größenmodus; Direct2D zeichnet das Dokument dann in den
Gerätekontext des Steuerelements. Auf einem Drucker wird das Bild mit 300 dpi gezeichnet.
Administration
Fehlerbehebung
Keine