[← Utils](../README.md)

# Utils/Objects

Chart-object utilities. Everything lives in `namespace TSN`.

## Main features
- **Create objects in one call**: wrappers over `ObjectCreate` + `ObjectSet*` for lines, trends, channels, text, arrows, edit fields, buttons, rectangles, events and Fibonacci (`CNativeoGObjs`). All strings are `const string&`.
- **Draw a trade box**: paint the TP and SL rectangles of a trade (`CObjGUtils::DrawTPSL`).
- **Batch property change**: set one integer property on every object whose name starts with a prefix (`CObjGUtils::ModifiedIntegerPropertyByPrefix`).
- **Scheduled deletion**: queue object names with an expiry time and let `OnNewBar` delete, hide or show them (`CGraphicObjEliminations`).
- **Fibonacci helper**: define levels from strings, move the object and read the price of any level (`CFibbo`).
- **Show / hide macros**: `HIDE_OBJECT` and `SHOW_OBJECT` toggle an object's visibility across timeframes.

## Basic usage

### Create objects
```mql5
TSN::CNativeoGObjs::VLineCreate(0, "entry_line", 0, TimeCurrent(), clrRed, STYLE_DASH,
                                1, false, true, true, "Entry");  // width, back, selection, ray, tooltip

TSN::CNativeoGObjs::TextCreate(0, "lbl", 0, TimeCurrent(), SymbolInfoDouble(_Symbol, SYMBOL_BID),
                               "Hello", "Arial", 8, clrWhite, 0.0, ANCHOR_CENTER);
```

### Draw TP / SL
```mql5
TSN::CObjGUtils::DrawTPSL(0, 0, "trade1_", tp, sl, entry, time_entry, time_end,
                          clrGreen, clrRed, true, 1, STYLE_SOLID);  // fill, width, style
```

### Delete objects later
```mql5
TSN::CGraphicObjEliminations g_del;
g_del.Initilialize(0, 4, 4, 4);           // chart id + three array reserves

g_del.InitAddElement(TimeCurrent() + 3600); // objects added next are deleted after this time
g_del.AddElement("entry_line");
g_del.AddElement("lbl");

// on every new bar
g_del.OnNewBar(TimeCurrent());
```

### Fibonacci
```mql5
TSN::CFibbo fibbo;
fibbo.Create(0, "fibo", 0, clrGold, STYLE_DOT, 1, "Fibo");
fibbo.SetLevels("0;0.5;0.618;1", "clrGray;clrGold;clrOrange;clrGray", STYLE_DOT, 1, ';');
fibbo.Move(time1, time2, price1, price2);

double price = fibbo.GetLevelPrice(0.618);
```

> Only the most representative functions are shown here.