# SaaExtensions
{% hint style="warning" %}
This documentation is for SaaUI 1.1.0. If you using older version please update to latest version.
{% endhint %}
`Type`: `Class`
Contains useful extension methods that you may find helpful.
{% hint style="info" %}
Make sure you add namespace using SaaUI;
{% endhint %}
`Target`: `string`
`GetSize(string, font)` returns the size of the specified text when drawn with the specified font.
Usage:
```csharp
string str = "This is string";
Size strSize = str.GetSize(Font);
//OR
string str = "This is string";
Size strSize = SaaExtensions.GetSize(str, Font);
```
`Target`: `string[]`
`ToList(string[])` converts string array to List.
Usage:
```csharp
string[] strArray = { "Cat", "Dog", "Goat" };
List list = strArray.ToList();
//OR
string[] strArray = { "Cat", "Dog", "Goat" };
List list = SaaExtensions.ToList(strArray);
```
`Target: SaaToast`
`GetSize(SaaToast)` Gets the total Size (including Offsets) of all toasts that are open and visible on the screen.
`GetSize(SaaToast, ToastPosition)` Gets the total Size (including Offsets) of all toasts that are open and visible on the screen in the specified position.
Usage:
```csharp
Size TotalSize = saaToast1.GetSize();
Size BottomLeftSize = saaToast1.GetSize(ToastPosition.BottomLeft);
//OR
Size TotalSize = SaaExtensions.GetSize(saaToast1);
Size BottomLeftSize = SaaExtensions.GetSize(saaToast1, ToastPosition.BottomLeft);
```
`Target: Color`
`ToHex(Color)` converts color to hexadecimal like `#FFFF00`.
`ToRGB(Color)` converts color to RGB like `RGB(255,255,0)`.
Usage:
```csharp
Color _color = Color.Red;
string hexColor = _color.ToHex();
string rgbColor = _clor.ToRGB();
//OR
Color _color = Color.Red;
string hexColor = SaaExtensions.ToHex(_color);
string rgbColor = SaaExtensions.ToRGB(_color);
```
`Property: string`
`NewID` generates globally unique ids with no duplicates possible.
Usage:
```csharp
string Id = SaaExtensions.NewID;
```
{% hint style="info" %}
The possibility of generating same Ids for lifetime globally is 0%. This means you can rely on it without fearing of getting duplicate ids even if you are generating billions of ids per second.
It uses several individually generated [**universally unique identifier** (**UUID**)](https://en.wikipedia.org/wiki/Universally_unique_identifier) + locally created custom identifiers.
{% endhint %}
`Target: Color`
`GetTransparency(Color, Percentage)` makes a color transparent in the given percentage.
Usage:
```csharp
Color _color = Color.Red;
Color halfTranparentColor = _color.GetTransparency(50);
//OR
Color _color = Color.Red;
Color halfTranparentColor = SaaExtensions.GetTransparency(_color, 50);
```
`Target: Control`
`LocationRelativeToForm(Control)` returns the location of a control relative to where it appears on the form. No matter if the control is inside other containers or nested containers. This is different from `Control.Location`. `Control.Location` returns the location of the control relative to its parent container(panel, form etc).
Assuming you have a button in a panel on a form, see the illustrations below.
Usage:
```csharp
point location = button1.LocationRelativeToForm();
//OR
point location = SaaExtensions.LocationRelativeToForm(button1);
```
`Target: Control`
`MouseLocation(Control)` returns mouse location of a control relative to the parent form. If the mouse pointer is outside the form then it returns `Point.Empty`.
Usage:
```csharp
point Mouselocation = button1.MouseLocation();
//OR
point Mouselocation = SaaExtensions.MouseLocation(button1);
```
`Target: Control`
`InnerMouseLocation(Control)` returns mouse location of a control relative to itself. If the mouse pointer is outside the control then it returns -1 (both X and Y).
Usage:
```csharp
point InnerMouseLocation = button1.InnerMouseLocation();
//OR
point InnerMouseLocation = SaaExtensions.InnerMouseLocation(button1);
```
`Target: Control`
`SetDoubleBuffering(Control, true/false)` enables or disables doubleBuffering for a control.
Usage:
```csharp
button1.SetDoubleBuffering(true/false);
//OR
SaaExtensions.SetDoubleBuffering(button1, true/false);
```
`Target: String[]`
`Contains(string[], item, caseSensitive)` checks whether string array has the specified item in its collection. `caseSensitive` is optional argument and tells whether case-sensitivity must be respected. *I.e* with `caseSensitive` set `true`, **Name** and **name** are not same.
Usage:
```csharp
string[] str = { "Cat", "Dog", "Chicken"};
bool isContains = str.Contains("dog"); //returns true
bool isContains = str.Contains("dog", true); //returns false
//OR
bool isContains = SaaExtensions.Contains(str, "dog", [ true/false]);
```
`Target: Control`
`CopyPropertiesFrom(ToControl, FromControl, PropertiesToCopy)` copies specified propeties from one control to another.
`CopyPropertiesFromExcept(ToControl, FromControl, PropertiesNotToCopy)` copies all properties except the ones specified from one control to another.
Imaging you have designed a beautiful button and you want another button to have same design. Instead of again designing that button, you can just copy from the other one. I.e **Color**, **Text**, **Icon** etc. Works with any control.
Usage:
```csharp
button2.CopyPropertiesFrom(button1, {"BackColor", "Font", "Text"}); // Copies BackColor, Font and Text from button1 to button2.
button2.CopyPropertiesFromExcept(button1, {"BackColor", "Text"}); // Copies all properties except BackColor,and Text from button1 to button2.
//OR
SaaExtensions.CopyPropertiesFrom(button2, button1, {"BackColor", "Font", "Text"});
SaaExtensions.CopyPropertiesFromExcept(button2, button1, {"BackColor", "Text"});
```
`Target: Object`
`GetProperty(object, propertyName)` returns property value of an object.
`SetProperty(object, propertyName, value)` sets value to a property of an object. An `object` can be anything like `class`, `Button`, `Form`. In the following example we assume the `object` to be a `Form`.
Usage:
```csharp
myForm.SetProperty("BackColor", Color.Blue);
Color bc = (Color)myForm.GetProperty("BackColor");
//OR
SaaExtensions.SetProperty(myForm1, "BackColor", Color.Blue);
Color bc = (Color)SaaExtensions.GetProperty(myForm1, "BackColor");
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.saabytes.com/extension/saaextensions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.