How to change the start button text

2022-08-17T22:38:17Z

2A01:E0A:965:5320:F90D:3F24:1396:D96D: tag the file as TUT

{{DISPLAYTITLE:TUT:How to change the start button text}}
# Open File Explorer and go to '''<code>C:/system/boot</code>'''
# Make a file ending with <code>.css</code>
# In the file type <br/><code>.start_button:after {<br/>  content: "Your text here";<br/>}</code>
# Save the file
# And reboot Windows 96
# '''Done!'''
{{DEFAULTSORT:TUT:How_to_change_the_start_button_text}}

Developing Applications

2022-08-17T16:18:43Z

2A01:E0A:965:5320:F90D:3F24:1396:D96D: changed the cli example to the new api

Windows 96 includes a flexible API for developing your own applications. All applications are ran under WRT, which is a partial sandbox and runtime provided by Windows 96 for applications.

Applications may be referred to as "bins", "WRT bins", "application bin", or "sysbins" depending on the context.

== Structure of an application ==
Windows 96 applications are simply JavaScript files without the .JS extension that include a WRT shebang (<code>//!wrt</code>). The shebang denotes that this regular file is a WRT bin, and must be the very first line in any WRT application. It may sometimes include a binary specification (BSPEC) suffix to describe some metadata about the application.

=== The binary specification (BSPEC) ===
As mentioned before, the binary specification (BSPEC) is a way to describe metadata for a WRT bin. It always follows the shebang on the same line, where the cumulative line size must not exceed 256 characters.

The BSPEC is a simple JSON object prefixed with <code>$BSPEC:</code> and contains the following fields:

* <code>icn</code> - The name of the icon to use.
* <code>cpr</code> - The copyright holder of the application.
* <code>dsc</code> - A basic description of the application.
* <code>frn</code> - The display name of the application.
* <code>aut</code> - The application author.
* <code>ssy</code> - The subsystem to use for this application. Can either be <code>gui</code> or <code>cli</code>.
* <code>ver</code> - The version of the application.

Below is an example of a binary specification declaration for the File Explorer application.<syntaxhighlight lang="javascript">
//!wrt $BSPEC:{"icn":"apps/explorer","cpr":"Copyright (C) Windows 96 Team 2021.","dsc":"System File Explorer","frn":"Explorer","ver":1}
</syntaxhighlight>

=== A GUI example program ===

Here is an example of a very basic Windows 96 GUI program:<syntaxhighlight lang="javascript" line="1">
//!wrt
const { Theme } = w96.ui;

class GUIApplication extends WApplication {
/**
* Application constructor.
*/
constructor() {
super();
}

/**
* Main entry point.
* @param {String[]} argv The program arguments.
*/
async main(argv) {
// Create the window
const mainwnd = this.createWindow({
title: "Sample Application",
body: "Sample text",
bodyClass: "sample-app",
taskbar: true,
resizable: true,
initialHeight: 480,
initialWidth: 640,
icon: await Theme.getIconUrl("mime/executable", '16x16')
}, true);

// Show the window
mainwnd.show();
}
}

return await WApplication.execAsync(new GUIApplication(), this.boxedEnv.args);
</syntaxhighlight>Save this file anywhere, without a file extension, and then double click to run it. You may need to refresh your explorer view to allow it to recognize this file as a program.

=== A CLI example program ===
Here is an example of a very basic Windows 96 terminal program:<syntaxhighlight lang="javascript" line="1">
//!wrt $BSPEC:{"ssy":"cli"}

const term = this.boxedEnv.term;
// If the program is not executed in a terminal, exit.
if (!term) return;

class CLIApplication extends WApplication {
/**
* Application constructor.
*/
constructor() {
super()
}

/**
* Main entry point.
* @param {String[]} argv The program arguments.
*/
async main(argv) {
super.main(argv);

// Write some text in the terminal.
term.writeln("Hello World!");
term.writeln("Welcome to the most useful app!");

// Get user input and store it in a variable.
let e = await term.prompt("Enter your first name: ");
term.writeln("Nice job " + e + "!");

let r = await term.prompt("Last name: ");
term.writeln(`Hi there ${e} ${r}!`);

// Pause the program.
await term.pause()
}
}

return await WApplication.execAsync(new CLIApplication(), this.boxedEnv.args, this);
class CLIApplication extends WApplication {

constructor() {
super();
}

async main(argv, executionContext) {
super.main(argv);

let term = executionContext.term;

if (!term) {
return
};

// Write some text in the terminal.
term.writeln('Hello World!');
term.writeln('Welcome to the most useful app!');

// Get user input and store it in a variable.
let firstName = await term.prompt("Enter your first name: ");
term.writeln('Nice job ' + firstName + '!');

let lastName = await term.prompt('Last name: ');
term.writeln(`Hi there ${firstName} ${lastName}!`);

// Pause the program.
await term.pause();
}
}

return await WApplication.execAsync(new CLIApplication(), this.boxedEnv.args);
</syntaxhighlight>Save this file anywhere, without a file extension, and then enter the path to the file in the terminal to run it.

== Running an application ==
To run an application, you can either:

* Run it from the Run box or terminal with its executable name, if the binary is present in any directory denoted by the PATH environment variable.
* Double click it in an explorer window to execute it in the current directory. (Only work for GUI apps).
* Enter the absolute path of the application bin in a Run box or terminal window.

Wiki96 - User contributions [en]

How to change the start button text

Developing Applications