Skip to content

Commit 1c7c6d2

Browse files
Manivannan-EManivannan-E
authored
Merge pull request #1513 from syncfusion-content/910709-Prepare-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 9462479 + 4a49e45 commit 1c7c6d2

File tree

1 file changed

+152
-114
lines changed

1 file changed

+152
-114
lines changed

‎wpf/ToolBar/ToolBarAdv-state.md

Lines changed: 152 additions & 114 deletions
Original file line numberDiff line numberDiff line change
@@ -14,120 +14,86 @@ 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/New.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/Open.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+
ToolBarAdv toolbar1 = new ToolBarAdv();
54+
// Add a button to the toolbar1
55+
toolbar1.Items.Add(new Button
56+
{
57+
Content = new Image
58+
{
59+
Source = new BitmapImage(new Uri("Images/Open.png")),
60+
Stretch = Stretch.Uniform
61+
},
62+
Height = 40,
63+
Width = 40,
64+
ToolTip = "Open Folder",
65+
Margin = new Thickness(5, 0, 5, 0)
66+
});
67+
// Add toolbar1 to the ToolBarTrayAdv
68+
toolBarTray.ToolBars.Add(toolbar1);
69+
// Set Floating location for the floating toolbar
70+
toolbar1.FloatingBarLocation = new Point(500, 300);
71+
// Set the floating toolbar state to floating
72+
ToolBarManager.SetToolBarState(toolbar1, ToolBarState.Floating);
73+
// Add buttons to the floating toolbar
74+
toolbar1.Items.Add(new Button
75+
{
76+
Content = new Image
77+
{
78+
Source = new BitmapImage(new Uri("Images/Save.png")),
79+
Stretch = Stretch.Uniform
80+
},
81+
Height = 40,
82+
Width = 40,
83+
ToolTip = "Save",
84+
Margin = new Thickness(5, 0, 5, 0)
85+
});
86+
// Set the ToolBarTrayAdv as the top tray for the ToolBarManager
87+
toolBarManager.TopToolBarTray = toolBarTray;
88+
// Set the ToolBarManager as the main content
89+
this.Content = toolBarManager;
12390

12491
{% endhighlight %}
12592

12693
{% endtabs %}
12794

12895
![ToolBarAdv-state-img1](ToolBarAdv-state-images/ToolBarAdv-state-img1.jpeg)
12996

130-
13197
ToolBarAdv can be floated only when it is hosted in ToolBarManager.
13298

13399
## Specifying location for floating ToolBarAdv.
@@ -138,20 +104,14 @@ The location of the floating ToolBarAdv can be changed using the `FloatingBarLo
138104

139105
{% highlight XAML %}
140106

141-
<syncfusion:ToolBarAdv FloatingBarLocation="50,50"/>
142-
143-
107+
<syncfusion:ToolBarAdv FloatingBarLocation="50,50"/>
144108

145109
{% endhighlight %}
146110

147111
{% highlight C# %}
148112

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

156116
{% endhighlight %}
157117

@@ -172,19 +132,97 @@ Following code restricts docking at the top:
172132

173133
{% highlight XAML %}
174134

175-
<syncfusion:ToolBarManager CanDockAtTop="False"/>
135+
<syncfusion:ToolBarManager CanDockAtTop="False"/>
176136

137+
{% endhighlight %}
138+
139+
{% highlight C# %}
177140

141+
ToolBarManager toolBarManager = new ToolBarManager();
142+
toolBarManager.CanDockAtTop = false;
178143

179144
{% endhighlight %}
180145

181-
{% highlight C# %}
146+
{% endtabs%}
147+
148+
## ToolBarStateChanged event
149+
150+
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.
182151

183-
ToolBarManager toolBarManager = new ToolBarManager();
152+
NewState: Gets the current state of the ToolBarAdv control.
184153

185-
toolBarManager.CanDockAtTop = false;
154+
OldState: Gets the previous state of the ToolBarAdv control.
186155

156+
{% tabs %}
157+
158+
{% highlight XAML %}
159+
160+
<syncfusion:ToolBarManager x:Name="toolBarManager" >
161+
<syncfusion:ToolBarManager.TopToolBarTray>
162+
<syncfusion:ToolBarTrayAdv >
163+
<syncfusion:ToolBarAdv ToolBarStateChanged="Toolbar1_ToolBarStateChanged" ToolBarName="Standard" Band="0">
164+
<Button syncfusion:ToolBarAdv.Label="Open Document"
165+
syncfusion:ToolBarAdv.Icon="Images/Open.png">
166+
<Image Source="Images/Open.png" Width="16" Height="16"/>
167+
</Button>
168+
<syncfusion:ToolBarAdv Band="1" ToolBarName="Extras">
169+
<Button syncfusion:ToolBarAdv.Label="Save Document"
170+
syncfusion:ToolBarAdv.Icon="Images/Save.png">
171+
<Image Source="Images/Save.png" Width="16" Height="16"/>
172+
</Button>
173+
</syncfusion:ToolBarAdv>
174+
</syncfusion:ToolBarAdv>
175+
</syncfusion:ToolBarTrayAdv>
176+
</syncfusion:ToolBarManager.TopToolBarTray>
177+
</syncfusion:ToolBarManager>
178+
179+
{% endhighlight %}
180+
181+
{% highlight C# %}
187182

183+
ToolBarManager toolBarManager = new ToolBarManager();
184+
ToolBarTrayAdv toolBarTray = new ToolBarTrayAdv();
185+
ToolBarAdv toolbar1 = new ToolBarAdv();
186+
// Subscribe to the ToolBarStateChanged event for toolbar1
187+
toolbar1.ToolBarStateChanged += Toolbar1_ToolBarStateChanged;
188+
toolbar1.Items.Add(new Button
189+
{
190+
Content = new Image
191+
{
192+
Source = new BitmapImage(new Uri("Images\\Open.png")),
193+
Stretch = Stretch.Uniform
194+
},
195+
Height = 40,
196+
Width = 40,
197+
ToolTip = "Open Folder",
198+
Margin = new Thickness(5, 0, 5, 0)
199+
});
200+
ToolBarAdv toolbar2 = new ToolBarAdv();
201+
toolbar2.Items.Add(new Button
202+
{
203+
Content = new Image
204+
{
205+
Source = new BitmapImage(new Uri("Images\\Save.png")),
206+
Stretch = Stretch.Uniform
207+
},
208+
Height = 40,
209+
Width = 40,
210+
ToolTip = "Save",
211+
Margin = new Thickness(5, 0, 5, 0)
212+
});
213+
// Add ToolBars to the ToolBarTrayAdv
214+
toolBarTray.ToolBars.Add(toolbar1);
215+
toolBarTray.ToolBars.Add(toolbar2);
216+
// Set the ToolBarTrayAdv as the top tray for the ToolBarManager
217+
toolBarManager.TopToolBarTray = toolBarTray;
218+
this.Content = toolBarManager;
219+
220+
private void Toolbar1_ToolBarStateChanged(object sender, ToolBarStateChangedEventArgs e)
221+
{
222+
// Access the new and old values
223+
object oldValue = e.OldState;
224+
object newValue = e.NewState;
225+
}
188226

189227
{% endhighlight %}
190228

0 commit comments

Comments
 (0)