You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/button.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -261,6 +261,10 @@ A [BarButton](xref:@ActiproUIRoot.Controls.Bars.BarButton).`Click` and [BarMenuI
261
261
262
262
See the [Using Commands](using-commands.md) topic for more information on commands.
263
263
264
+
### Focus Behavior
265
+
266
+
In cases where you wish for the button to remain focused after a click, set the [BarButton](xref:@ActiproUIRoot.Controls.Bars.BarButton).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarButton.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
267
+
264
268
## Input Gesture Text
265
269
266
270
The control can have input gesture text associated with it that describes a related keyboard shortcut, and is displayed in the screen tip for the control or in the menu item itself.
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/checkbox.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -217,6 +217,10 @@ A [BarCheckBox](xref:@ActiproUIRoot.Controls.Bars.BarCheckBox).`Click` and [BarM
217
217
218
218
See the [Using Commands](using-commands.md) topic for more information on commands.
219
219
220
+
### Focus Behavior
221
+
222
+
In cases where you wish for the checkbox to remain focused after a click, set the [BarCheckBox](xref:@ActiproUIRoot.Controls.Bars.BarCheckBox).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarButton.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
223
+
220
224
## Input Gesture Text
221
225
222
226
The control can have input gesture text associated with it that describes a related keyboard shortcut,
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/combobox.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -240,6 +240,10 @@ The [PopupOpeningCommand](xref:@ActiproUIRoot.Controls.Bars.Primitives.BarMenuGa
240
240
241
241
See the [Using Commands](using-commands.md) topic for more information on commands.
242
242
243
+
### Focus Behavior
244
+
245
+
In cases where you wish for the combobox to remain focused after selecting an item or committing a value, set the [BarComboBox](xref:@ActiproUIRoot.Controls.Bars.BarComboBox).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.Primitives.BarMenuGalleryHostBase.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
246
+
243
247
## Screen Tips
244
248
245
249
The controls support screen tips, which are formatted tool tips.
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/control-basics.md
+14-1Lines changed: 14 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -194,6 +194,16 @@ For example, a regular button will execute its command and raise a `Click` event
194
194
195
195
See the [Using Commands](using-commands.md) topic for more information on commands.
196
196
197
+
### Focus Behavior
198
+
199
+
When the primary invocation of a control occurs, such as a button click, the `InvocationFocusBehavior` setting on the control determines what happens with focus. This property is available on most controls that can appear in a ribbon or toolbar context.
200
+
201
+
The value options are:
202
+
203
+
-[Default](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Default) - When the control is in a focus scope like a ribbon or toolbar, it will try to restore focus to control that last control had focus outside of the containing focus scope.
204
+
-[None](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.None) - The Actipro logic for the control will not do any focus processing itself. However note that in some cases, external base classes may still process focus.
205
+
-[Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self) - The control will focus itself.
206
+
197
207
## Input Gesture Text
198
208
199
209
Input gestures are keyboard shortcuts that provide access to a control's command. For instance, <kbd>Ctrl</kbd>+<kbd>C</kbd> is commonly associated with the clipboard copy command.
@@ -264,9 +274,11 @@ Here is a list of common attached properties that are related to concepts descri
264
274
|[MediumIconProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.MediumIconProperty)| Medium 24x24 size image. |
265
275
|[LargeIconProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.LargeIconProperty)| Large 32x32 size image. |
266
276
|[TitleProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.TitleProperty)| String title that can override the label in screen tips and customization UI. |
277
+
|[InvocationFocusBehaviorProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.InvocationFocusBehaviorProperty)| Determine how focus is moved when the primary invocation, such as a click on a button, occurs on the control. |
267
278
|[VariantSizeProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.VariantSizeProperty)| The current variant size of the control. Unless otherwise indicated, this property should only be manually set when the control is standalone, and not hosted by a bar control. |
268
279
|[CanCloneToRibbonQuickAccessToolBarProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.CanCloneToRibbonQuickAccessToolBarProperty)| Whether the control can clone to the ribbon [Quick Access Toolbar](../ribbon-features/quick-access-toolbar.md). |
269
-
| [HasExternalHeaderProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.HasExternalHeaderProperty) | Whether an external header (image/label) should be rendered for the control when in a ribbon control group stack. |}
280
+
|[HasExternalHeaderProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.HasExternalHeaderProperty)| Whether an external header (image/label) should be rendered for the control when in a ribbon control group stack. |
281
+
}
270
282
@if (wpf) {
271
283
| Attached Property | Description |
272
284
|-----|-----|
@@ -276,6 +288,7 @@ Here is a list of common attached properties that are related to concepts descri
276
288
|[MediumImageSourceProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.MediumImageSourceProperty)| Medium 24x24 size image. |
277
289
|[LargeImageSourceProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.LargeImageSourceProperty)| Large 32x32 size image. |
278
290
|[TitleProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.TitleProperty)| String title that can override the label in screen tips and customization UI. |
291
+
|[InvocationFocusBehaviorProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.InvocationFocusBehaviorProperty)| Determine how focus is moved when the primary invocation, such as a click on a button, occurs on the control. |
279
292
|[VariantSizeProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.VariantSizeProperty)| The current variant size of the control. Unless otherwise indicated, this property should only be manually set when the control is standalone, and not hosted by a bar control. |
280
293
|[CanCloneToRibbonQuickAccessToolBarProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.CanCloneToRibbonQuickAccessToolBarProperty)| Whether the control can clone to the ribbon [Quick Access Toolbar](../ribbon-features/quick-access-toolbar.md). |
281
294
|[HasExternalHeaderProperty](xref:@ActiproUIRoot.Controls.Bars.BarControlService.HasExternalHeaderProperty)| Whether an external header (image/label) should be rendered for the control when in a ribbon control group stack. |
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/gallery.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -403,6 +403,10 @@ A [RibbonGallery](xref:@ActiproUIRoot.Controls.Bars.RibbonGallery).`SelectionCha
403
403
404
404
See the [Using Commands](using-commands.md) topic for more information on commands.
405
405
406
+
### Focus Behavior
407
+
408
+
In cases where you wish for an in-ribbon gallery to remain focused after a click on one of its gallery items or the **More** button's popup menu items, set the [RibbonGallery](xref:@ActiproUIRoot.Controls.Bars.Primitives.BarMenuGalleryHostBase).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarPopupButton.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
409
+
406
410
## MVVM Support
407
411
408
412
The optional companion [MVVM Library](../mvvm-support.md) defines a [BarGalleryViewModel](xref:@ActiproUIRoot.Controls.Bars.Mvvm.BarGalleryViewModel) class that is intended to be used as a view model for galleries.
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/popup-button.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -291,6 +291,10 @@ The `PopupOpeningCommand`'s can-execute result determines the enabled state of t
291
291
292
292
See the [Using Commands](using-commands.md) topic for more information on commands.
293
293
294
+
### Focus Behavior
295
+
296
+
In cases where you wish for the button to remain focused after a click on one of its popup menu items, set the [BarPopupButton](xref:@ActiproUIRoot.Controls.Bars.BarPopupButton).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarPopupButton.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
297
+
294
298
## Screen Tips
295
299
296
300
The controls support screen tips, which are formatted tool tips.
Copy file name to clipboardExpand all lines: Documentation/topics/bars/controls/split-button.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -286,6 +286,10 @@ The [PopupOpeningCommand](xref:@ActiproUIRoot.Controls.Bars.Primitives.BarPopupB
286
286
287
287
See the [Using Commands](using-commands.md) topic for more information on commands.
288
288
289
+
### Focus Behavior
290
+
291
+
In cases where you wish for the button to remain focused after a click on it or one of its popup menu items, set the [BarSplitButton](xref:@ActiproUIRoot.Controls.Bars.BarSplitButton).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarPopupButton.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
292
+
289
293
## Input Gesture Text
290
294
291
295
The control can have input gesture text associated with it that describes a related keyboard shortcut, and is displayed in the screen tip for the control or in the menu item itself.
@@ -189,6 +189,10 @@ A `TextChanged` event is raised whenever the control's text changes.
189
189
190
190
See the [Using Commands](using-commands.md) topic for more information on commands.
191
191
192
+
### Focus Behavior
193
+
194
+
In cases where you wish for the textbox to remain focused after committing a value, set the [BarTextBox](xref:@ActiproUIRoot.Controls.Bars.BarTextBox).[InvocationFocusBehavior](xref:@ActiproUIRoot.Controls.Bars.BarTextBox.InvocationFocusBehavior) property to [Self](xref:@ActiproUIRoot.Controls.Bars.InvocationFocusBehavior.Self).
195
+
192
196
## Screen Tips
193
197
194
198
The controls support screen tips, which are formatted tool tips.
0 commit comments