mirror of
https://github.com/FellippeHeitor/InForm.git
synced 2025-01-15 03:49:56 +00:00
123 lines
4.7 KiB
Markdown
123 lines
4.7 KiB
Markdown
# INFORM-PE
|
|
|
|
|
|
|
|
[InForm-PE](https://github.com/a740g/InForm-PE) is a GUI engine and WYSIWYG interface designer for [QB64-PE](https://github.com/a740g/QB64pe). It is a fork of [InForm](https://github.com/FellippeHeitor/InForm), authored by [Fellippe Heitor](https://github.com/FellippeHeitor).
|
|
|
|
InForm-PE's main goal is to generate *event-driven* QB64-PE applications. This means that you design a graphical user interface with interactive controls and then write the code to respond to such controls once they are manipulated.
|
|
|
|
Wiki: <https://github.com/a740g/InForm-PE/wiki>
|
|
|
|
## FEATURES
|
|
|
|
- WYSIWYG interface designer
|
|
- Event-driven application design
|
|
- Works on Windows, Linux & macOS
|
|
- Everything is statically linked (no shared library dependencies)
|
|
|
|
## USAGE
|
|
|
|
Install InForm-PE and QB64-PE side-by-side in their own directories. There is no need to copy InForm-PE files to the QB64-PE directory.
|
|
|
|
> The following directory setup is recommended
|
|
|
|
```text
|
|
<some-drive-or-directory>
|
|
|
|
|
|-------InForm-PE>
|
|
| |
|
|
| |-------<UiEditor[.exe]>
|
|
|
|
|
|-------<QB64pe>
|
|
|
|
|
|-------<qb64pe[.exe]>
|
|
```
|
|
|
|
Assuming your setup is like the above, do the following:
|
|
|
|
- Open Terminal and change to the InForm-PE directory using an appropriate OS command
|
|
- Run `setup_inform_lnx.sh`, `setup_inform_osx.command` or `setup_inform_win.cmd` depending on the OS you are on. This will run make with the correct parameters. If the build fails, ensure QB64-PE is installed in the **QB64pe** directory (next to the InForm-PE directory). If QB64-PE is installed elsewhere, then edit the setup scripts to change the location
|
|
- Once InFrom-PE is compiled, you will find the UiEditor[.exe] executable in the InForm-PE directory
|
|
- Run UiEditor[.exe] to start designing your forms
|
|
- After your form looks the way you want it to, click **File > Save** to export its contents and generate a **.bas** source file. Two files are exported:
|
|
- **.frm** - the generated form in QB64-PE code. This can be loaded back into InForm-PE's designer or manually edited in QB64-PE or any text editor later, if you want to adjust fine details
|
|
- **.bas** - the actual program you will add your code to
|
|
|
|
***You add code to respond to events.***
|
|
|
|
- *Click*
|
|
- *MouseEnter/MouseLeave* (hover)
|
|
- *FocusIn/FocusOut*
|
|
- *MouseDown/MouseUp* (events preceding a Click)
|
|
- *KeyPress*
|
|
- *TextChanged* (for text box controls)
|
|
- *ValueChanged* (for track bars, lists and dropdown lists)
|
|
|
|
***There are also events that occur in specific moments, to which you can respond/add code.***
|
|
|
|
- *BeforeInit*, triggered just before the form is shown.
|
|
- *OnLoad*, triggered right after the form is first shown.
|
|
- *BeforeUpdateDisplay*, triggered everytime the form is about to be repainted.
|
|
- *BeforeUnload*, triggered when the user tries to close the program, either via clicking the window's X button, right click in the task bar -> Close or with Alt+F4 (Windows only).
|
|
- *FormResized*, triggered when a form with the CanResize property is resized at runtime.
|
|
|
|
***The following files need to be copied to your project directory for it to compile.***
|
|
|
|
> Required
|
|
|
|
```text
|
|
InForm/InFormVersion.bas
|
|
InForm/InForm.bi
|
|
InForm/InForm.ui
|
|
InForm/xp.uitheme
|
|
```
|
|
|
|
> Required only when GIF picturebox is used
|
|
|
|
```text
|
|
InForm/extensions/gifplay.bi
|
|
InForm/extensions/gifplay.bm
|
|
```
|
|
|
|
> Required only when using legacy InForm MessageBox routines (use [QB64-PE's native common dialog functions](https://qb64phoenix.com/qb64wiki/index.php/Keyword_Reference_-_By_usage#Window_and_Desktop) when writing new code)
|
|
|
|
```text
|
|
InForm/extensions/MessageBox.bi
|
|
InForm/extensions/MessageBox.bas
|
|
```
|
|
|
|
## EXAMPLES
|
|
|
|
| Name | Author |
|
|
|------|-------------|
|
|
| Bin2Include | SpriggsySpriggs |
|
|
| Calculator | Terry Ritchie |
|
|
| ClickTheVoid | Fellippe Heitor |
|
|
| ClockPatience | Richard Notley |
|
|
| DuckShoot | Richard Notley |
|
|
| ebacCalculator | George McGinn |
|
|
| Fahrenheit-Celsius | Richard Notley |
|
|
| Fireworks2 | Fellippe Heitor |
|
|
| GIFPlaySample | Fellippe Heitor |
|
|
| GravitationSimulation | Richard Notley |
|
|
| InFormPaint | Fellippe Heitor |
|
|
| InsideOutsideTriangle | Richard Notley |
|
|
| Lander1 | B+ |
|
|
| Lander2 | B+ |
|
|
| Mahjong | Richard Notley |
|
|
| MasterMindGuessTheSequence | TempodiBasic |
|
|
| Pelmanism | Richard Notley |
|
|
| PictureGrid | Richard Notley |
|
|
| PlayFX | Samuel Gomes |
|
|
| RockPaperScissorsSpockLizard | TempodiBasic |
|
|
| Stopwatch | Fellippe Heitor |
|
|
| TextFetch | B+ |
|
|
| TicTacToe | Fellippe Heitor |
|
|
| TicTacToe2 | Fellippe Heitor |
|
|
| Trackword | Richard Notley |
|
|
| WordClock | Fellippe Heitor |
|
|
| wordSearch | George McGinn |
|
|
|
|
## NOTES
|
|
|
|
- This requires the latest version of [QB64-PE](https://github.com/QB64-Phoenix-Edition/QB64pe/releases/latest). More accurately, it only works with QB64-PE v3.8.0 or above.
|