SImage

Verwaltet ein Bild. [Mehr ...]

Vererbung

Basisklassen(n)

abgeleitete Klassen

SImage

Attribute

public:

Attribut	Typ	Beschreibung
stretchToClientSize	BOOL	Bild ist genauso groß wie sein Container

protected:

Attribut	Typ	Beschreibung
hbmp	HBITMAP	Originalbild
hbmpStretch	HBITMAP	gestrecktes Bild
isvisible	bool	Sichtbarkeit des Bildes
orgSize	SSize	Originalgröße des geladenen Bitmaps.
pos	SRect	Position des Bildes
stretchEnable	BOOL	Strecken des Bildes aktiviert
stretchProportional	BOOL	proportionale Bildstreckung
transparentColor	COLORREF	Transparente Farbe

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
createIcon		HICON	Erstellt ein Icon aus dem geladenen Bild.
createTransparentMask		HBITMAP	Erstellt eine transparenzmaske aus dem geladenen Bild.
deinit		void	Schließt das Bild.
enableStretch	BOOL stretch=true	void	Schaltet das Strecken des Bildes an/aus.
getHandle		HBITMAP	Gibt das Handle (HBITMAP) auf ein eventuell enthaltenes Bitmap zurück.
getOrgSize		SSize	Liefert die Originalgröße des Bildes.
getRect		SRect	Liefert Größe und Position des Rechtecks, das das Bild umschließt.
getRect	const SRect& cr	SRect	Liefert Größe und Position des Rechtecks, das das Bild umschließt.
hide		void	Blendet das Bild aus
isShown		bool
isStretchEnabled		BOOL	Überprüft, ob das Bild gestreckt wurde.
load	const SString& filename, int posx, int posy, bool visible	bool	Lädt ein Bild in das SImage-Objekt.
move	int posx, int posy	void	Verschiebt ein Bild zur angegebenen Position.
onPaint	HDC windc, HWND owner=NULL	void	Zeichnet das Bitmap auf den angegeben DC.
setProportional	BOOL proportional=true	void	Aktiviert/Deaktiviert die proportionale Bildstreckung (Zoom).
setSize	int width, int height	void	Darzustellende Größe, das Bitmap wird auf diese Größe gezoomt. noStretch wird auf false gesetzt und muss gegebenenfalls neu eingestellt werden, wenn sich die Größe geändert hat.
setTransparentColor	COLORREF color	void	Legt die transparente Farbe fest.
show	bool visible=true	void	Zeigt das Bild an/blendet es aus

Detailbeschreibung SImage

Verwaltet ein Bild.

Im Moment müssen die Bilder im Bitmap-Format (*.bmp) vorliegen.
Folgende Speicherorte sind für Bilder möglich:

im Ressourcen-Verzeichnis (%projektpfad%\SVL-Resources); diese Bilder können in die Programmdatei eingepackt und im ganzen Programm über ihren Dateinamen angesprochen werden (z.B. "hintergrund.bmp")
im Programmverzeichnis; diese Bilder können ebenfalls nur über ihren Dateinamen angesprochen werden; allerdings liegen sie als einzelne Dateien neben der Programmdatei vor
in einem anderen Verzeichnis; bei diesen Bildern muss zur Verwendung der Pfad mit angegeben werden, also "c:\\bilder\\hintergrund.bmp" oder "..\\bilder\\hintergrund.bmp"

Funktionsbeschreibungen

createIcon() HICON

Erstellt ein Icon aus dem geladenen Bild.

Es muss eine Transparenzfarbe angegeben sein.
Beachte: das zurückgegebene Icon muss nach Verwendung gelöscht werden (mit DeleteIcon())

createTransparentMask() HBITMAP

Erstellt eine transparenzmaske aus dem geladenen Bild.

Es muss eine Transparenzfarbe angegeben sein.
Beachte: das zurückgegebene HBITMAP muss nach Verwendung gelöscht werden (mit DeleteObject())

deinit() void

Schließt das Bild.

enableStretch(BOOL stretch=true) void

Schaltet das Strecken des Bildes an/aus.

Parameter:

stretch

Bild strecken

getHandle() HBITMAP

Gibt das Handle (HBITMAP) auf ein eventuell enthaltenes Bitmap zurück.

Rückgabe:

HBITMAP

NULL oder das Handle des enthaltenen Bitmaps.

getOrgSize() SSize

Liefert die Originalgröße des Bildes.

Wir zum Stretchen und Zoomen benötigt.

Rückgabe:

SSize

die Original-Größe des geladenen Bitmaps in Pixel

getRect() SRect

Liefert Größe und Position des Rechtecks, das das Bild umschließt.

Rückgabe:

SRect

aktuelle Größe und Position des Bildes

getRect(const SRect& cr) SRect

Liefert Größe und Position des Rechtecks, das das Bild umschließt.

Rückgabe:

SRect

aktuelle Größe und Position des Bildes

hide() void

Blendet das Bild aus

isShown() bool

Rückgabe:

bool	Sichtbarkeit des Bildes

isStretchEnabled() BOOL

Überprüft, ob das Bild gestreckt wurde.

Rückgabe:

BOOL	Streckung aktiviert

load(const SString& filename, int posx, int posy, bool visible) bool

Lädt ein Bild in das SImage-Objekt.

Parameter:

filename	Dateiname des Bildes
posx	X-Position des Bildes (relativ zum Container)
posy	Y-Position des Bildes (relativ zum Container)
visible	Bild darstellen

Rückgabe:

bool	Bild erfolgreich geladen.

move(int posx, int posy) void

Verschiebt ein Bild zur angegebenen Position.

Parameter:

posx	neue X-Position
posy	neue Y-Position

onPaint(HDC windc, HWND owner=NULL) void

Zeichnet das Bitmap auf den angegeben DC.

Wenn paintSizeX bzw paintSizeY gleich Null sind wird das Bitmap auf die Größe des Clientbereiches des Owner-Fensters gestrecht.

Parameter:

windc	zu verwendender DeviceContext
owner	HWND des Eigentümers

setProportional(BOOL proportional=true) void

Aktiviert/Deaktiviert die proportionale Bildstreckung (Zoom).

Wirkt nur in Verbindung mit enableStretch().

Parameter:

proportional

proportionale Bildstreckung

setSize(int width, int height) void

Darzustellende Größe, das Bitmap wird auf diese Größe gezoomt. noStretch wird auf false gesetzt und muss gegebenenfalls neu eingestellt werden, wenn sich die Größe geändert hat.

Parameter:

width	Ausgabe-Breite
height	Ausgabe-Höhe

setTransparentColor(COLORREF color) void

Legt die transparente Farbe fest.

Parameter:

color

die Farbe die transparent sein soll, oder:

SIMG_NO_TRANSPARENT für keine Transparenz
SIMG_TRANSPARENT_LIKE_TOPLEFT für Farbübernahme aus dem linken, oberen Pixel

show(bool visible=true) void

Zeigt das Bild an/blendet es aus

Parameter:

visible

Sichtbarkeit

<< Gesamtübersicht

<< Klassenübersicht

Details der Klasse

Funktionsbeschreibungen