|
|
       
This topic covers the specific events exposed by the RadRibbonBar control and its sub elements. The events are first grouped by control and then by their general purpose.
RadRibbonBar
The RadRibbonBar provides the following events that can be used for customization purposes:
- ApplicationButtonDoubleClick - occurs when the user double clicks on the application button. The ApplicationButtonDoubleClick event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- PreviewSelectedTabChanged - occurs when the selected tab is going to be changed. The PreviewSelectedTabChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- SelectedTabChanged - occurs when the selected tab has changed. The SelectedTabChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
Tip |
|---|
When a RadRibbonTab is selected the lifecycle of the raised events is:
- PreviewSelectedTabChanged
- SelectedTabChanged
|
Tip |
|---|
|
You could cancel the selection process by setting the RadRoutedEventArgs's Handled property to True in the PreviewSelectedTabChanged event handler.
|
Tip |
|---|
|
When your application is started the SelectedTabChanged event is always raised. However, the PreviewSelectedTabChanged is not.
|
- ToolBarPositionChanged - occurs when the location of the toolbar has changed. The ToolBarPositionChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- MinimizedChanged - occurs when the ribbon bar minimized state has changed. The MinimizedChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- MinimizedPopupOpenStateChanged - occurs when the ribbon bar minimized popup open state has changed. The MinimizedPopupOpenStateChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- HelpRequested - occurs when the user clicks on the help button. The HelpRequested event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
- CollapsedChanged - occurs when the ribbon bar collapsed state has changed. The CollapsedChanged event handler receives two arguments:
-
The sender argument contains the RadRibbonBar. This argument is of type object, but can be cast to the RadRibbonBar type.
-
A RadRoutedEventArgs object.
RadGallery
- ActivatePreview - occurs when the mouse cursor is over a gallery item. The ActivatePreview event handler receives two arguments:
-
The sender argument contains the RadGallery. This argument is of type object, but can be cast to the RadGallery type.
-
A RadRoutedEventArgs object.
- DeactivatePreview - occurs when the mouse cursor leaves the gallery item. The DeactivatePreview event handler receives two arguments:
-
The sender argument contains the RadGallery. This argument is of type object, but can be cast to the RadGallery type.
-
A RadRoutedEventArgs object.
Tip |
|---|
When a preview should be activated for a gallery item, the lifecycle of the raised events is: - ActivatePreview
- DeactivatePreview
|
RadRibbonGroup
- LaunchDialog - occurs when ribbon bar collapsed state has changed. The LaunchDialog event handler receives two arguments:
-
The sender argument contains the RadRibbonGroup. This argument is of type object, but can be cast to the RadRibbonGroup type.
-
A RadRoutedEventArgs object.
See Also
|