LemonUI/Quick Start

From Lemon
< LemonUI
Revision as of 23:58, 2 August 2020 by Lemon (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Starting with LemonUI is easy! You just need to learn about a couple of things and you should be ready to go.

Notes

This Quick Start guide assumes that you already know C# and you know how Tick events work on SHVDN2, SHVDN3 and FiveM.

The Object Pool

The Object Pool stores all of your UI Containers like Menus and Timer Bar Collections. While Object Pools are not mandatory for Menus to work, they provide extra features like Updating the position of your UI when the Resolution and Safe Zone are changed, and being able to change multiple processable elements at once.

You can create a new Object Pool by calling it's constructor. It does not takes any parameters.

// Recommendation: Make this a private readonly field
ObjectPool pool = new ObjectPool();

When using the Object Pool, you need to call a function every Tick to make sure that is able to detect changes and draw the UI. This function is Process().

// This goes inside of your Tick event
pool.Process();

After adding the Object Pool, you are ready to add Menus and Timer Bars!

Menus and Items

LemonUI allows you to create Rockstar-like menus with the NativeMenu class. You can create them by calling the constructor with the Title and Subtitle of the menu.

// Recommendation: Make this a readonly field
NativeMenu menu = new NativeMenu("Title", "Subtitle");

Just remember that Menus need to be added into an Object Pool!

pool.Add(menu);

After this, your new menu is ready to work.

Now, let's continue with the Menu Items. There are multiple types of items that you can use in your menu:

Normal Items

The normal items only show a Title and that's it. They are simple, but have a lot of features that you can change (check the Visual Studio Object Browser for more information).

You can create them like this:

NativeItem item = new NativeItem("Title"); // No Description
NativeItem item = new NativeItem("Title", "Description of the Item"); // With Description
NativeItem item = new NativeItem("Title", "Description of the Item", "Info"); // With Description and Alternative Title on the right

Then, you are free to add it onto the menu by calling Add():

menu.Add(item);

All of the menu items are added with the same function, no matter their type.

Checkbox Items

Checkbox Items work and behave like normal items, but they have a Checkbox that can be toggled on and off. You create them like this:

NativeCheckboxItem checkbox = new NativeCheckboxItem("Checkbox"); // Disabled by Default
NativeCheckboxItem checkbox = new NativeCheckboxItem("Checkbox", true); // Enabled by Default
NativeCheckboxItem checkbox = new NativeCheckboxItem("Checkbox", "Description"); // Disabled by Default with a Description
NativeCheckboxItem checkbox = new NativeCheckboxItem("Checkbox", "Description", true); // Enabled by Default with a Description

You can check if the Checkbox is toggled on or off by checking the Checked property.

List Items

List Items have a list of items that you can change by scrolling left and right.

On LemonUI, you need to specify the type of items that they will have, like this:

NativeListItem<string> // List of Strings
NativeListItem<int> // List of Int
NativeListItem<Color> // List of Colors

As an example, we will create list of ints:

NativeListItem<int> list = new NativeListItem<int>("Title"); // No Description
NativeListItem<int> list = new NativeListItem<int>("Title", "Description of the Item"); // With Description

You can add the objects that you want on the item when you create it by specifying them after the parameters, like this:

NativeListItem<int> list = new NativeListItem<int>("Title", 1, 2, 3, 4); // No Description with 1, 2, 3 and 4 as items
NativeListItem<int> list = new NativeListItem<int>("Title", "Description of the Item", 177013); // With Description with 177013 as an item

You can get the current item via the SelectedItem property, and the current index via the SelectedIndex property.

Slider Item

LemonUI has Sliders that you can move from Left to Right to change a numeric value. They can be created like this:

NativeSliderItem item = new NativeSliderItem("Title"); // No Description with a Maximum of 100 and a Value of 0
NativeSliderItem item = new NativeSliderItem("Title", "Description"); // With Description, a Maximum of 100 and a Value of 0
NativeSliderItem item = new NativeSliderItem("Title", 255, 160); // No Description with a Maximum of 255 and a Value of 160
NativeSliderItem item = new NativeSliderItem("Title", "Description", 255, 160); // With Description, a Maximum of 255 and a Value of 160

You can get the value with the Value property. There is also another property called Multiplier that will set the increase when moving the slider (for example, increase the numeric value by 10 instead of by 1).