Legen Sie verschiedene Compiler-Optionen fest.
#OPTION {LARGEMEM32 | VERSION3 | VERSION4 | VERSION5 | WIN95 | ANSIAPI}
Legen Sie verschiedene Compiler-Optionen fest.
Typ:Richtlinie |Kategorie:Präprozessor
PBXB64-Status:VERFÃœGBAR
PBXB64-Zertifizierung: [ZERTIFIZIERT GETESTET]
#OPTION LARGEMEM32
Für 32-Bit-Windows-Anwendungen setzt diese Option das Flag „Large Memory Model“. Dadurch kann Ihre Anwendung mehr als das ursprüngliche Limit von 2 Gigabyte Arbeitsspeicher nutzen. Abhängig von der verwendeten Windows-Version und dem installierten Speicher kann die genaue Erhöhung von Computer zu Computer unterschiedlich sein. In den meisten Fällen sind Sie wahrscheinlich auf insgesamt etwa 3 Gigabyte beschränkt.
#OPTION VERSION3, VERSION4, VERSION5
Wenn die Metaanweisung #OPTION mit einer der VERSION-Direktiven verwendet wird, steuert sie das Tag „Mindestversion von Windows“, das in Ihren kompilierten Code geschrieben wird. Wenn die von Ihnen ausgewählte Version gleich oder niedriger als die ausgeführte Windows-Version ist, wird die Anwendung ausgeführt. Im Gegenzug passt Windows die an Ihr Programm gesendeten Nachrichten entsprechend dieser Versionsnummer an, sodass Ihr Programm keine Nachrichten von einer späteren Windows-Version verarbeiten muss. Das Versions-Tag kann sich auch auf das Erscheinungsbild und Verhalten allgemeiner Windows-Dialoge auswirken.
Wenn umgekehrt das von Ihnen ausgewählte Versions-Tag höher ist als die ausgeführte Windows-Version, zeigt Windows eine Fehlermeldung an, anstatt Ihre Anwendung auszuführen. Beispielsweise würde die Ausführung einer VERSION5-Anwendung auf einer VERSION4-Plattform fehlschlagen. Es liegt in Ihrer Verantwortung sicherzustellen, dass Ihr Programm nur die Windows-Funktionen verwendet, die in der angegebenen Windows-Version vorhanden sind. Rufen Sie beispielsweise keine API auf, die nur in Windows XP vorhanden ist, wenn Sie möchten, dass Ihr Programm unter Windows 98 ausgeführt wird.
#OPTION VERSION3
Verwenden Sie #OPTION VERSION3, damit die kompilierte Ausgabedatei mindestens Windows 95 oder NT 3.1 erfordert. Dazu gehören Windows 95, 98, ME, Windows NT 3.1-4.0, Windows 2000, XP, Windows 2003, Windows Vista, Windows 7 und höher.
#OPTION VERSION4
Verwenden Sie #OPTION VERSION4 (Standard), damit die kompilierte Ausgabedatei mindestens Windows 95 oder NT4 erfordert. Dazu gehören Windows 95, 98, ME, Windows NT 4.0, Windows 2000, XP, Windows 2003, Windows Vista, Windows 7 und höher.
#OPTION VERSION5
Verwenden Sie #OPTION VERSION5, damit die kompilierte Ausgabedatei mindestens Windows 2000 erfordert. Dazu gehören Windows 2000, XP, Windows 2003, Windows Vista, Windows 7 und höher.
#OPTION WIN95
Windows95, Windows98 und Windows ME bieten keine Unicode-Unterstützung für Windows-API-Funktionen. Normalerweise wäre es dadurch möglich, Ihre kompilierten Programme auf diesen Betriebssystemen auszuführen, da diese Version von PowerBASIC vollständige Unterstützung für Wide Unicode-Text bietet. Wenn Sie jedoch #OPTION WIN95 in Ihrem Quellcode angeben, fügt PowerBASIC ein vollständiges Unicode-Emulationspaket in Ihre ausführbare Datei oder DLL ein, damit sie auf diesen Betriebssystemen ordnungsgemäß ausgeführt werden können. Diese Option führt dazu, dass Ihr Code etwas größer wird, daher sollte sie nur bei Bedarf verwendet werden.
#OPTION ANSIAPI
Diese Version von PowerBASIC bietet vollständige Unterstützung für Wide Unicode-Text. Daraus folgt, dass die interne Laufzeitbibliothek Unicode-Versionen von Funktionen in der Windows-API aufrufen würde. In einigen recht seltenen Fällen kann dies zu einer Inkompatibilität mit dem von Ihnen geschriebenen Code führen, wenn Ihr Code ANSI-Funktionen in der Windows-API aufruft. Wenn Sie #OPTION ANSIAPI in Ihrem Quellcode angeben, ruft PowerBASIC nur ANSI-Versionen dieser Funktionen auf. Durch diese Option wird Ihr Code etwas größer und sollte daher nur bei Bedarf verwendet werden.
#OPTION controls compiler-wide build decisions such as memory model, compatibility version, and ANSI/Unicode API selection. Use the page to choose the exact spelling that matches the target Windows behavior you need.
Validation evidence: The currently generated #OPTION page documents the supported flags and the supported output compatibility contract; keep the page paired with the version-targeting tests and the API-encoding helpers.
Diese Referenzseite soll durch ein fokussiertes Compile- oder Laufzeitbeispiel belegt sein. Das Beispiel soll Eingaben, erwartete Ausgabe oder Exit-Code und erforderliche Windows-Ressourcen oder Include-Dateien nennen.
Allgemeine Übersichtsseiten sollten trotzdem sagen, welche Familie gemeint ist, welche konkreten Befehlsseiten die Implementierung tragen und welche Formen nur der Navigation dienen. So bleibt die Seite detailliert genug, ohne so zu tun, als wäre sie eine vollständige Befehlsreferenz.