Hilfe zu SKCaption.DLL

INHALT:

1. Über diese DLL
2. Funktionsübersicht
3. Anmerkungen

1. Über diese DLL

Autor:

Sebastian König
 Friedrich-Ebert-Straße 13
37586 Dassel

Telefon:        (0 55 64) 21 71
email:          feedback@sekoenig.de
Homepage:       http://www.sekoenig.de
Diese DLL ist Freeware und darf frei weitergegeben und benutzt werden, solange nichts verändert wird. Das Copyright liegt jedoch beim Autor.
Für eventuelle Schäden, die durch die Nutzung der DLL entstehen wird keine Haftung übernommen. Allerdings wurde die DLL ausführlich getestet, ohne das Schäden entstanden sind.
Wenn sie diese DLL für ein eigenes Programm nutzen, würde ich mich über eine kurze Erwähnung im Programm (About-Box, Hilfe, etc.) mit (evtl.) Verweis auf meine Homepage [http://www.sekoenig.de] freuen.

Viel Spaß mit der DLL!

2. Funktionsübersicht

2.1. SKCptn_CustomizeCaption()

Mit dieser Funktion wird die Titelleiste geändert.
Selbst gewählt werden können:
Schriftart, Textfarbe und Hintergrundfarbe (mit oder ohne Farbverlauf)

Funktionsbeschreibung: 

SKCptn_CustomizeCaption(hwnd, ac_li, ac_re, ic_li, ic_re, ta, ti, font)

hwnd  -  Integer   : Handle des Fensters, dessen Titelleiste verändert
                     werden soll
ac_li  -  COLORREF  : Hintergrundfarbe (aktiv)  links
ac_re  -  COLORREF  : Hintergrundfarbe (aktiv)  rechts
ic_li  -  COLORREF  : Hintergrundfarbe (inaktiv)  links
ic_re  -  COLORREF  : Hintergrundfarbe (inaktiv)  rechts
ta     -  COLORREF  : Textfarbe (aktiv)
ti     -  COLORREF  : Textfarbe (inaktiv)
font   -  Longint   : Handle des Fonst für das Menü

Rückgabewert: Immer 1
Wenn ac_li und ac_re gleich sind, wird die Titelzeile ohne Farbverlauf dargestellt.

Wenn für font eine 0 übergeben wird, wird die Standard- Titelleisten-Schriftart verwendet.

Die benötigten COLORREF-Werte können mit SKCptn_RGB() erzeugt werden.
Wenn 'SetTrueColor 1' gesetzt ist, können auch Profan RGB-Werte benutzt werden.

2.2: SKCptn_CleanUp()

Diese Funktion muss vor dem Schließen eines mit SKCptn_CustomizeCaption() veränderten Fensters aufgerufen werden.

Funktionsbeschreibung: 

SKCptn_CleanUp(hwnd)

hwnd - Handle des Fensters

Rückgabewert: Immer 1

2.3: SCptn_GetFontHeight()

Diese Funktion ermittelt die Schrifthöhe der Standard-Titelleisten- Schriftart.

Funktionsbeschreibung: 

SKCptn_GetFontHeight()

Keine Parameter

Rückgabewert: Integer - Höhe der Schriftart

2.4: SCptn_RGB()

Mit dieser Funktion können die COLORREF-Werte für SKCptn_CustomizeMenu() erzeugt werden.

Funktionsbeschreibung: 

SKCptn_RGB(r, g, b)

r - Integer : Rotanteil
g - Integer : Grünanteil
b - Integer : Blauanteil

Rückgabewert: COLORREF (Longint) - Windows RGB-Wert

2.5: SKCptn_VersionInfo

Die Funktion ermittelt die Versionsnummer der Dll.

Funktionsbeschreibung: 

SKCptn_VersionInfo(string)

string - Bereich : Adresse des Zielstrings

Rückgabewert: Immer 1

3. Anmerkungen

3.1. Farbverlauf auf Systemem mit geringer Farbtiefe

Wenn die DLL auf Systemen eingesetzt wird, die mit einer Farbtiefe < 16 bit arbeiten, wird automatisch kein Farbverlauf angezeigt. Stattdessen werden ac_li und ic_li (siehe hier) als Hintergrundfarben benutzt.

3.2. Mehrmaliges Ändern der Titelleiste

Wenn man im Laufe des Programms die Titelleiste eines Fensters mehrmals Ändern will, muss vor jedem erneuten SKCptn_CustomizeCaption() SKCptn_CleanUp() aufgerufen werden.

3.3. Danksagung

Dank an: