SApplication

Diese Klasse verwaltet die Anwendung. [Mehr ...]

Vererbung

Basisklassen(n)

abgeleitete Klassen

SApplication

Attribute

public:

Attribut	Typ	Beschreibung
absoluteAllWindows	SNumList	Liste der Zeiger auf alle SWindows
exitCode	int
hInstApp	HINSTANCE	Instanz-Handle der Anwendung
hInstPrev	HINSTANCE	Instanz-Handle der vorherigen Anwendung
lastFocusWindow	HWND	Fenster, dass den Focus hat oder als letztes hatte.
pMainWnd	SWindow*	Zeiger auf das Hauptfenster der Anwendung
sound	SSound	Hintergrundsound

protected:

Attribut	Typ	Beschreibung
acceleratorList	SNumList
brush	HBRUSH	Handle der Standard-Hintergrundfarbe
captureList	SNumList	Speicher für weiterzuleitende Nachrichten.
gdiplusStartupInput	GdiplusStartupInput	Startup-Struktur für GDI+
gdiplusToken	ULONG_PTR
nextDlgItemID	int	Interner Zähler zur eindeutigen ID-Vergabe bei Dialog-Items
timer	UINT	Anwendungs-Timer
windowList	SNumList	Liste aller Haupt-Fenster und Dialoge

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
addCaptureMessage	HWND destHwnd, HWND msgToHwnd, UINT msg, void* pData=NULL	void	Leitet eine Kopie der Nachricht an einen weiteren Empfänger.
AppTimer	HWND hwnd , UINT msg, UINT id , DWORD curTime	void CALLBACK	Callbackfunktion des Application-Timers.
getBrush		HBRUSH
getNewDlgItemID		int	Liefert eine neue ID für ein Steuerelement.
getWindow	HWND hwnd	SWindow*	Ermittelt einen Zeiger auf das gesuchte Fenster.
init	HINSTANCE thisInst, HINSTANCE prevInst, int nFensterStil	int	Erzeugt das Hauptfenster der Anwendung und zeigt es an.
reallySetForegroundWindow	HWND ahWnd	void	Bringt ein Fenster wirklich nach vorn.
regAccelerator	HWND h	int	Speichert ein Fester, das AcceleratorKeys verarbeiten möchte.
regWindow	SWindow* pWnd, WNDCLASSEX* wincl	int	Speichern eines neuen Fensters in der Fensterliste der Anwendung.
removeCaptureMessage	HWND destHwnd, UINT msg = 0	void	Leitet eine Kopie der Nachricht an einen weiteren Empfänger.
removeWindow	SWindow *pWnd	void	löscht ein Fenster aus der Fensterliste der Anwendung
translateAccelerator	MSG msg	BOOL
winProcApp	HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam	LRESULT	Verteilfunktion für die Windows-Messages,
workCapture	HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam	void	Verarbeitet/Sendet die weiterzuleitenden Windows-Messages.

protected:

Name	Parameter	Rückgabewert	Beschreibung
deinit		void	Räumt beim Beenden des Programms werwendete Systemressourcen auf.

Detailbeschreibung SApplication

Diese Klasse verwaltet die Anwendung.

Es wird eine globales Instanz dieser Klasse Namens 'theApp' in jedem Programm erstellt. Alle Fenster, die das Programm erstellt werden in diesem Objekt registriert. Es dient somit als Schaltstelle für alle Nachrichten, die zwischen den einzelnen Fenstern bzw. zwischen Windows und den Fenstern der Anwendung ausgetauscht werden.

Funktionsbeschreibungen

addCaptureMessage(HWND destHwnd, HWND msgToHwnd, UINT msg, void* pData=NULL) void

Leitet eine Kopie der Nachricht an einen weiteren Empfänger.

Parameter:

destHwnd	Ziel-Fenster-Handle
msgToHwnd	Fenster-Handle, an das die Nachricht weitergeleitet werden soll
msg	Nachrichtennummer
pData	Daten der Nachricht

AppTimer(HWND hwnd ,UINT msg,UINT id , DWORD curTime) void CALLBACK

Callbackfunktion des Application-Timers.

deinit() void

Räumt beim Beenden des Programms werwendete Systemressourcen auf.

getBrush() HBRUSH

Rückgabe:

HBRUSH

die Standard-Füllfarbe

getNewDlgItemID() int

Liefert eine neue ID für ein Steuerelement.

Rückgabe:

int

neue ID

getWindow(HWND hwnd) SWindow*

Ermittelt einen Zeiger auf das gesuchte Fenster.

Rückgabe:

SWindow*	Zeiger auf das SWindow-Fenster,
SWindow*	wenn das Fenster nicht gefunden wurde wird NULL zurückgegeben.

init(HINSTANCE thisInst, HINSTANCE prevInst, int nFensterStil) int

Erzeugt das Hauptfenster der Anwendung und zeigt es an.

Das Hauptfenster muss als globales Objekt angelegt sein.

Parameter:

thisInst	die Instanz der Anwendung
prevInst	vorherige Instanz der Anwendung (bei Win32 immer NULL)
nFensterStil	z.Z. nicht verwendet

Rückgabe:

int

immer 1

reallySetForegroundWindow(HWND ahWnd) void

Bringt ein Fenster wirklich nach vorn.

Parameter:

ahWnd

Fenster-Handle des zu zeigenden Fensters

regAccelerator(HWND h) int

Speichert ein Fester, das AcceleratorKeys verarbeiten möchte.

Das Fenster wird alle KEY-Messages seiner Childs erhalten.

regWindow(SWindow* pWnd, WNDCLASSEX* wincl) int

Speichern eines neuen Fensters in der Fensterliste der Anwendung.

Bei Bedarf wird die Fensterklasse im Betriebssystem registriert.
pWnd=Zeiger auf das neue Fenster
wincl=WINCLASSEX-Struktur mit Beschreibung der Klasse, zur Registrierung der Klasse im Betriebssystem