Upgrade WIN32.HLP

PowerBASIC, Inc. hat eine etwas umfangreichere Version der Hilfedatei WIN32.HLP zum kostenlosen Download bereitgestellt. Diese neuere von Microsoft erstellte Hilfe zeigt zur Erläuterung auch Bilder und enthält zusätzlich ein Tutorial zu Grundlagen der Windows-Programmierung. Wie die bisherige WIN32.HLP ist diese neuere Variante nur in englischer Sprache verfügbar.

Eigenartigerweise ist die neue Download-Datei WIN32.ZIP mit 5,7 MByte sogar kleiner als das frühere 8,5 MByte große ZIP-Archiv. Nach dem Auspacken der ZIP-Datei erhält man die Datei SETUP.EXE, welche man unter Windows ausführt, um schließlich die Datei WIN32.HLP und die zugehörigen Konfigurationsdateien zu erhalten. Es empfiehlt sich, für diese Dateien ein eigenes Verzeichnis anzulegen. Soll unbedingt das Verzeichnis der alten WIN32.HLP genutzt werden, so müssen dort vorher alle zu WIN32.HLP gehörenden Dateien einschließlich der versteckten WIN32.GID (Hidden) gelöscht werden.

Die kontextsensitiven Informationen aus WIN32.HLP erhalten Sie nur, wenn die zugehörige Pfadangabe innerhalb der PowerBASIC IDE über Window - Options... - General richtig angegeben ist.

Welche Informationen enthält die WIN32.HLP?

1. Zunächst findet man wichtige Grundlagen zur Windows-Programmierung. Hierzu klicken Sie auf "Inhalt". Nach Themen geordnet findet man Erläuterungen, Funktionsbeschreibungen und Auflistungen von möglichen Parametern und vordefinierten Konstanten. Leider sind Syntax der Funktionen und alle Beispiele nur für die Programmiersprache C ausgelegt. Die Umsetzung nach PowerBASIC findet man jeweils entweder in der Datei WIN32API.INC oder in einer der anderen Include-Dateien im PowerBASIC Unterverzeichnis WinAPI.

2. Alle Inhalte lassen sich mit der von anderen Windows-Programmen bekannten "Suchen"-Funktion nach Stichwörtern durchsuchen. Es empfiehlt sich über Optionen die Suche so zu konfigurieren, dass alle Wörter angezeigt werden, welche die eingegebene Buchstabenfolge enthalten.

Natürlich kann man ähnlich einem Stichwortverzeichnis auch einzelne Themen über einen bestimmten Suchbegriff mit Hilfe der vorgegebenen Indexliste finden.

3. Bestimmt sind Sie in PowerBASIC-Beispielprogrammen schon auf Begriffe wie GetOpenFilename, SetTimer, GetClientRect, MoveToEx usw. gestoßen. Solche Begriffe finden Sie nicht in der PowerBASIC-Dokumentation! Es handelt sich um Funktionsaufrufe, welche Windows direkt ansprechen. Eine Beschreibung solcher Funktionen erscheint unverzüglich, wenn Sie das Caret (ja so heißt nun einmal der Cursor unter Windows), wenn man also das Caret im PowerBASIC-Editor auf einen dieser Begriffe setzt und die F1-Funktionstaste drückt. In der praktischen Arbeit benötigt man häufig die genaue Beschreibung der jeweiligen Parameter und natürlich auch eine Auflistung und Erläuterung der zugehörigen Konstanten.

War der gewähle Begriff ein PowerBASIC Befehl (z.B. OPEN), so erscheint natürlich auch weiterhin die zugehörige Beschreibung aus der PowerBASIC-Online-Hilfe. Ist jedoch ein Begriff in der PowerBASIC-Befehlsliste nicht zu finden, so wird automatisch die WIN32.HLP benutzt. Vorausgesetzt natürlich, die WIN32.HLP ist wie oben beschrieben installiert.

Die hier zum Download angebotene WIN32.HLP trägt das Datum 18.06.1998 - stammt also noch aus der Zeit lange vor Windows XP. Neuere Beschreibungen findet man im Internet auf diesen Seiten von Microsoft.

Mit einem Umfang von mehr als 200 MByte stellen die Informationen dort die von PowerBASIC zur Verfügung gestellte WIN32.HLP mit vergleichsweise bescheidenen 24 MByte Dateigröße deutlich in den Schatten. Es wäre jedoch falsch zu glauben, dass die WIN32.HLP nicht mehr sinnvoll zu nutzen sei.

Viele Programmierer nutzen gerne ältere Beschreibungen, weil man dabei in der Regel nicht prüfen muss, ob die dort beschriebenen API-Funktionen und zugehörigen Konstanten für alle Windows-Versionen zur Verfügung stehen. Fast alle wichtigen API-Aufrufe aus den frühen 32-bit Windows-Versionen NT/95/98 stehen auch weiterhin in aktuellen Windows-Varianten zur Verfügung. Das MSDN (Microsoft Developer Network) stellt zwar umfangreichere und weitaus aktuellere Beschreibungen zur Verfügung, manche Teile sind dabei aber nur in Verbindung mit Windows XP, Windows 2003 oder gar Windows CE zu nutzen. Wenn Sie also lieber die grundlegenden Informationen gültig für "Windows 95 und höher" bzw. "Windows NT 4.0 und höher" in möglichst knapper und übersichtlicher Form suchen, so sollten Sie ruhig auf die WIN32.HLP zurückgreifen.

Zusätzlich empfehlen sich natürlich noch Fachbücher wie z.B. das Entwickler-Handbuch zur Win32-API von Charles Petzold.

Extras: