title | page_title | description | slug | tags | published | position |
---|---|---|---|---|---|---|
Minimization |
Minimization |
Check our "Minimization" documentation article for the RadOutlookBar {{ site.framework_name }} control. |
radoutlookbar-features-minimization |
minimization |
true |
4 |
You can use the Minimization feature of the RadOutlookBar to create more user friendly and "MS Outlook look and feel" applications. The following properties are related to this feature:
-
IsMinimizable – boolean property that allows you to choose whether the RadOutlookBar can be minimized or not. The default value of the property is True.
-
IsMinimized - boolean property that allows you to choose whether the RadOutlookBar should be minimized or not. The default value of the property is False.
-
MinimizedWidth – double property that represents the width that will be set to the RadOutlookBar, when it is minimized. The default value of the property is 30.
-
MinimizedWidthThreshold – double property that represents at what width the RadOutlookBar will go in minimized state, when it is resized via the vertical resizer
-
IsVerticalResizerVisible – boolean property that allows you to show or hide the vertical resizer
-
VerticalResizerAlignment – property of type ResizerAlignment that has two predefined values – Left, Right. With this property you can choose where to be placed the vertical resizer
The default value of the IsMinimizable property is True:
{{region xaml-radoutlookbar-features-minimization_0}} <telerik:RadOutlookBar Width="250" Height="390"> <telerik:RadOutlookBarItem Header="Contact 1" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 2" Icon="../Images/OutlookBar/contactsBig.png" IsSelected="True"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 3" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> </telerik:RadOutlookBar> {{endregion}}
Setting the IsMinimizable property to False will disable the Minimization feature of the RadOutlookBar:
{{region xaml-radoutlookbar-features-minimization_1}} <telerik:RadOutlookBar Width="250" Height="390" IsMinimizable="False"> <telerik:RadOutlookBarItem Header="Contact 1" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 2" Icon="../Images/OutlookBar/contactsBig.png" IsSelected="True"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 3" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> </telerik:RadOutlookBar> {{endregion}}
The IsMinimized property allows you to manually control the state of the RadOutlookBar. When set to the RadOutlookBar is minimized:
{{region xaml-radoutlookbar-features-minimization_2}} <telerik:RadOutlookBar Width="250" Height="390" IsMinimized="True"> <telerik:RadOutlookBarItem Header="Contact 1" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 2" Icon="../Images/OutlookBar/contactsBig.png" IsSelected="True"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 3" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> </telerik:RadOutlookBar> {{endregion}}
The default value of the MinimizedWidth property is 30. However, you can change that size to better fit your scenario:
{{region xaml-radoutlookbar-features-minimization_3}} <telerik:RadOutlookBar Width="250" Height="390" IsMinimized="True" MinimizedWidth="60"> <telerik:RadOutlookBarItem Header="Contact 1" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 2" Icon="../Images/OutlookBar/contactsBig.png" IsSelected="True"> </telerik:RadOutlookBarItem> <telerik:RadOutlookBarItem Header="Contact 3" Icon="../Images/OutlookBar/contactsBig.png"> </telerik:RadOutlookBarItem> </telerik:RadOutlookBar> {{endregion}}
You can also take advantage of the vertical resizer to change the state of the RadOutlookBar. By default when the size of the RadOutlookBar exceeds 34, it's restored. Otherwise the control is minimized.
Furthermore, you can set the MinimizedWidthThreshold to control when to change the RadOutlookBar state, when it is resized via the vertical resizer.