Skip to content

Commit e2526d2

Browse files
Manivannan-EManivannan-E
authored
Merge pull request #1509 from syncfusion-content/910709-UG-document-for-the-StateChanged-event-in-the-WPF-ToolbarAdv-control
WPF-910709 : Update the ToolBarStateChangedEvent description in ToolBarAdv's UG documentation in WPF.
2 parents 9f811f0 + 0e4bb19 commit e2526d2

File tree

1 file changed

+152
-112
lines changed

1 file changed

+152
-112
lines changed

‎wpf/ToolBar/ToolBarAdv-state.md

Lines changed: 152 additions & 112 deletions
Original file line numberDiff line numberDiff line change
@@ -14,120 +14,87 @@ ToolBarAdv provides different states such as Docking, Floating or Hidden. It can
1414

1515
{% highlight XAML %}
1616

17-
<syncfusion:ToolBarManager x:Name="toolBarManager" >
18-
19-
<syncfusion:ToolBarManager.TopToolBarTray>
20-
21-
<syncfusion:ToolBarTrayAdv >
22-
23-
<syncfusion:ToolBarAdv ToolBarName="Standard" Band="0">
24-
25-
<Button syncfusion:ToolBarAdv.Label="New Document"
26-
syncfusion:ToolBarAdv.Icon="Images/NewDocumentHS.png">
27-
28-
<Image Source="Images/NewDocumentHS.png" Width="16" Height="16"/>
29-
30-
</Button>
31-
32-
<Button syncfusion:ToolBarAdv.Label="Open Document"
33-
syncfusion:ToolBarAdv.Icon="Images/openHS.png">
34-
35-
<Image Source="Images/openHS.png" Width="16" Height="16"/>
36-
37-
</Button>
38-
39-
<syncfusion:ToolBarAdv Band="1" ToolBarName="Extras"
40-
syncfusion:ToolBarManager.ToolBarState="Floating"
17+
<syncfusion:ToolBarManager x:Name="toolBarManager" >
18+
<syncfusion:ToolBarManager.TopToolBarTray>
19+
<syncfusion:ToolBarTrayAdv >
20+
<syncfusion:ToolBarAdv ToolBarName="Standard" Band="0">
21+
<Button syncfusion:ToolBarAdv.Label="New Document"
22+
syncfusion:ToolBarAdv.Icon="Images/New.png">
23+
<Image Source="Images/NewDocumentHS.png" Width="16" Height="16"/>
24+
</Button>
25+
<Button syncfusion:ToolBarAdv.Label="Open Document"
26+
syncfusion:ToolBarAdv.Icon="Images/Open.png">
27+
<Image Source="Images/OpenDocument.png" Width="16" Height="16"/>
28+
</Button>
29+
<syncfusion:ToolBarAdv Band="1" ToolBarName="Extras"
30+
syncfusion:ToolBarManager.ToolBarState="Floating"
4131
FloatingBarLocation="500,300">
42-
43-
<Button syncfusion:ToolBarAdv.Label="Insert Picture"
44-
syncfusion:ToolBarAdv.Icon="Images/InsertPictureHS.png">
45-
46-
<Image Source="Images/InsertPictureHS.png" Width="16" Height="16"/>
47-
48-
</Button>
49-
50-
<Button syncfusion:ToolBarAdv.Label="Insert Hyperlink"
51-
syncfusion:ToolBarAdv.Icon="Images/InsertHyperlinkHS.png">
52-
53-
<Image Source="Images/InsertHyperlinkHS.png" Width="16" Height="16"/>
54-
55-
</Button>
56-
57-
<Button syncfusion:ToolBarAdv.Label="Insert Table"
58-
syncfusion:ToolBarAdv.Icon="Images/TableHS.png">
59-
60-
<Image Source="Images/TableHS.png" Width="16" Height="16"/>
61-
62-
</Button>
63-
64-
</syncfusion:ToolBarAdv>
65-
66-
</syncfusion:ToolBarAdv>
67-
68-
</syncfusion:ToolBarTrayAdv>
69-
70-
</syncfusion:ToolBarManager.TopToolBarTray>
71-
72-
<Grid >
73-
74-
<Grid.RowDefinitions>
75-
76-
<RowDefinition Height="*"/>
77-
78-
<RowDefinition Height="Auto"/>
79-
80-
</Grid.RowDefinitions>
81-
82-
<ScrollViewer >
83-
84-
<Grid Margin="20">
85-
86-
<Border CornerRadius="2" Background="Black"
87-
Opacity="0.3" Width="600" Height="700">
88-
89-
<Border.Effect>
90-
91-
<BlurEffect Radius="15"/>
92-
93-
</Border.Effect>
94-
95-
</Border>
96-
97-
<RichTextBox Width="600" Height="700" Padding="20"></RichTextBox>
98-
99-
</Grid>
100-
101-
</ScrollViewer>
102-
103-
</Grid>
104-
105-
</syncfusion:ToolBarManager>
106-
107-
32+
<Button syncfusion:ToolBarAdv.Label="Save Document"
33+
syncfusion:ToolBarAdv.Icon="Images/Save.png">
34+
<Image Source="Images/SaveDocument.png" Width="16" Height="16"/>
35+
</Button>
36+
<Button syncfusion:ToolBarAdv.Label="Insert Table"
37+
syncfusion:ToolBarAdv.Icon="Images/Insert.png">
38+
<Image Source="Images/InsertTable.png" Width="16" Height="16"/>
39+
</Button>
40+
</syncfusion:ToolBarAdv>
41+
</syncfusion:ToolBarAdv>
42+
</syncfusion:ToolBarTrayAdv>
43+
</syncfusion:ToolBarManager.TopToolBarTray>
44+
</syncfusion:ToolBarManager>
10845

10946
{% endhighlight %}
11047

11148
{% highlight C# %}
11249

113-
114-
ToolBarAdv toolBar = new ToolBarAdv();
115-
116-
toolBar.FloatingBarLocation = new Point(500, 300);
117-
118-
ToolBarManager.SetToolBarState(toolBar, ToolBarState.Floating);
119-
120-
Grid1.Children.Add(toolBar);
121-
122-
50+
ToolBarManager toolBarManager = new ToolBarManager();
51+
//Initialize ToolBarTrayAdv
52+
ToolBarTrayAdv toolBarTray = new ToolBarTrayAdv();
53+
// Initialize toolbar1 and subscribe to ToolBarStateChanged event
54+
ToolBarAdv toolbar1 = new ToolBarAdv();
55+
// Add a button to the toolbar1
56+
toolbar1.Items.Add(new Button
57+
{
58+
Content = new Image
59+
{
60+
Source = new BitmapImage(new Uri("Images/Open.png")),
61+
Stretch = Stretch.Uniform
62+
},
63+
Height = 40,
64+
Width = 40,
65+
ToolTip = "Open Folder",
66+
Margin = new Thickness(5, 0, 5, 0)
67+
});
68+
// Add toolbar1 to the ToolBarTrayAdv
69+
toolBarTray.ToolBars.Add(toolbar1);
70+
// Set Floating location for the floating toolbar
71+
toolbar1.FloatingBarLocation = new Point(500, 300);
72+
// Set the floating toolbar state to floating
73+
ToolBarManager.SetToolBarState(toolbar1, ToolBarState.Floating);
74+
// Add buttons to the floating toolbar
75+
toolbar1.Items.Add(new Button
76+
{
77+
Content = new Image
78+
{
79+
Source = new BitmapImage(new Uri("Images/Save.png")),
80+
Stretch = Stretch.Uniform
81+
},
82+
Height = 40,
83+
Width = 40,
84+
ToolTip = "Save",
85+
Margin = new Thickness(5, 0, 5, 0)
86+
});
87+
// Set the ToolBarTrayAdv as the top tray for the ToolBarManager
88+
toolBarManager.TopToolBarTray = toolBarTray;
89+
// Set the ToolBarManager as the main content
90+
this.Content = toolBarManager;
12391

12492
{% endhighlight %}
12593

12694
{% endtabs %}
12795

12896
![ToolBarAdv-state-img1](ToolBarAdv-state-images/ToolBarAdv-state-img1.jpeg)
12997

130-
13198
ToolBarAdv can be floated only when it is hosted in ToolBarManager.
13299

133100
## Specifying location for floating ToolBarAdv.
@@ -140,18 +107,12 @@ The location of the floating ToolBarAdv can be changed using the `FloatingBarLo
140107

141108
<syncfusion:ToolBarAdv FloatingBarLocation="50,50"/>
142109

143-
144-
145110
{% endhighlight %}
146111

147112
{% highlight C# %}
148113

149-
150-
ToolBarAdv toolBar = new ToolBarAdv();
151-
152-
toolBar.FloatingBarLocation = new Point(50, 50);
153-
154-
114+
ToolBarAdv toolBar = new ToolBarAdv();
115+
toolBar.FloatingBarLocation = new Point(50, 50);
155116

156117
{% endhighlight %}
157118

@@ -174,18 +135,97 @@ Following code restricts docking at the top:
174135

175136
<syncfusion:ToolBarManager CanDockAtTop="False"/>
176137

138+
{% endhighlight %}
177139

140+
{% highlight C# %}
141+
142+
ToolBarManager toolBarManager = new ToolBarManager();
143+
toolBarManager.CanDockAtTop = false;
178144

179145
{% endhighlight %}
180146

181-
{% highlight C# %}
147+
{% endtabs%}
148+
149+
## ToolBarStateChanged event
182150

183-
ToolBarManager toolBarManager = new ToolBarManager();
151+
The [ToolBarStateChanged](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Tools.Controls.ToolBarAdv.html#Syncfusion_Windows_Tools_Controls_ToolBarAdv_ToolBarStateChanged) event is triggered when the state of a ToolBarAdv changes, such as when it is hidden, floated, or docked. This event passes an instance of [ToolBarStateChangedEventArgs](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Tools.Controls.ToolBarStateChangedEventArgs.html), which contains information about the state change, including the old state and the new state of the toolbar.
184152

185-
toolBarManager.CanDockAtTop = false;
153+
NewState: Gets the current state of the ToolBarAdv control.
186154

155+
OldState: Gets the previous state of the ToolBarAdv control.
187156

157+
{% tabs %}
158+
159+
{% highlight XAML %}
160+
161+
<syncfusion:ToolBarManager x:Name="toolBarManager" >
162+
<syncfusion:ToolBarManager.TopToolBarTray>
163+
<syncfusion:ToolBarTrayAdv >
164+
<syncfusion:ToolBarAdv ToolBarStateChanged="Toolbar1_ToolBarStateChanged" ToolBarName="Standard" Band="0">
165+
<Button syncfusion:ToolBarAdv.Label="Open Document"
166+
syncfusion:ToolBarAdv.Icon="Images/Open.png">
167+
<Image Source="Images/Open.png" Width="16" Height="16"/>
168+
</Button>
169+
<syncfusion:ToolBarAdv Band="1" ToolBarName="Extras">
170+
<Button syncfusion:ToolBarAdv.Label="Save Document"
171+
syncfusion:ToolBarAdv.Icon="Images/Save.png">
172+
<Image Source="Images/Save.png" Width="16" Height="16"/>
173+
</Button>
174+
</syncfusion:ToolBarAdv>
175+
</syncfusion:ToolBarAdv>
176+
</syncfusion:ToolBarTrayAdv>
177+
</syncfusion:ToolBarManager.TopToolBarTray>
178+
</syncfusion:ToolBarManager>
179+
180+
{% endhighlight %}
181+
182+
{% highlight C# %}
183+
184+
ToolBarManager toolBarManager = new ToolBarManager();
185+
ToolBarTrayAdv toolBarTray = new ToolBarTrayAdv();
186+
ToolBarAdv toolbar1 = new ToolBarAdv();
187+
// Subscribe to the ToolBarStateChanged event for toolbar1
188+
toolbar1.ToolBarStateChanged += Toolbar1_ToolBarStateChanged;
189+
toolbar1.Items.Add(new Button
190+
{
191+
Content = new Image
192+
{
193+
Source = new BitmapImage(new Uri("Images\\Open.png")),
194+
Stretch = Stretch.Uniform
195+
},
196+
Height = 40,
197+
Width = 40,
198+
ToolTip = "Open Folder",
199+
Margin = new Thickness(5, 0, 5, 0)
200+
});
201+
ToolBarAdv toolbar2 = new ToolBarAdv();
202+
toolbar2.Items.Add(new Button
203+
{
204+
Content = new Image
205+
{
206+
Source = new BitmapImage(new Uri("Images\\Save.png")),
207+
Stretch = Stretch.Uniform
208+
},
209+
Height = 40,
210+
Width = 40,
211+
ToolTip = "Save",
212+
Margin = new Thickness(5, 0, 5, 0)
213+
});
214+
// Add ToolBars to the ToolBarTrayAdv
215+
toolBarTray.ToolBars.Add(toolbar1);
216+
toolBarTray.ToolBars.Add(toolbar2);
217+
// Set the ToolBarTrayAdv as the top tray for the ToolBarManager
218+
toolBarManager.TopToolBarTray = toolBarTray;
219+
this.Content = toolBarManager;
220+
221+
private void Toolbar1_ToolBarStateChanged(object sender, ToolBarStateChangedEventArgs e)
222+
{
223+
// Access the new and old values
224+
object oldValue = e.OldState;
225+
object newValue = e.NewState;
226+
}
188227

189228
{% endhighlight %}
190229

191230
{% endtabs%}
231+

0 commit comments

Comments
 (0)