Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 34 additions & 34 deletions hub/apps/develop/input/focus-navigation-programmatic.md

Large diffs are not rendered by default.

48 changes: 24 additions & 24 deletions hub/apps/develop/input/focus-navigation.md

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions hub/apps/develop/input/guidelines-for-optical-zoom.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ ms.localizationpriority: medium

This article describes Windows zooming and resizing elements and provides user experience guidelines for using these interaction mechanisms in your apps.

> **Important APIs**: [**Windows.UI.Input**](/uwp/api/Windows.UI.Input), [**Input (XAML)**](/uwp/api/Windows.UI.Xaml.Input)
> **Important APIs**: [**Windows.UI.Input**](/uwp/api/Windows.UI.Input), [**Input (XAML)**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Input)

Optical zoom lets users magnify their view of the content within a content area (it is performed on the content area itself), whereas resizing enables users to change the relative size of one or more objects without changing the view of the content area (it is performed on the objects within the content area).

Expand Down Expand Up @@ -44,7 +44,7 @@ Use the following guidelines for apps that support either resizing or optical zo
- If maximum and minimum size constraints or boundaries are defined, use visual feedback to demonstrate when the user reaches or exceeds those boundaries.
- Use snap points to influence zooming and resizing behavior by providing logical points at which to stop the manipulation and ensure a specific subset of content is displayed in the viewport. Provide snap points for common zoom levels or logical views to make it easier for a user to select those levels. For example, photo apps might provide a resizing snap point at 100% or, in the case of mapping apps, snap points might be useful at city, state, and country/region views.

Snap points enable users to be imprecise and still achieve their goals. If you're using XAML, see the snap points properties of [**ScrollViewer**](/uwp/api/Windows.UI.Xaml.Controls.ScrollViewer).
Snap points enable users to be imprecise and still achieve their goals. If you're using XAML, see the snap points properties of [**ScrollViewer**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.scrollviewer).

There are two types of snap-points:

Expand Down
4 changes: 2 additions & 2 deletions hub/apps/develop/input/guidelines-for-visualfeedback.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Use visual feedback to show users when their interactions are detected, interpre
- See [XAML styles](../platform/xaml/xaml-styles.md) for more info on customizing the properties of a control, including visual state properties.
- See the [UserControl Class](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.usercontrol) for details on making changes to a control template
- Consider creating your own custom templated control if you need to make significant changes to a control template. For an example of a custom templated control, see the [Custom Edit Control sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/CustomEditControl) (UWP sample).
- Don't use touch visualizations in situations where they might interfere with the use of the app. For more info, see [**ShowGestureFeedback**](/uwp/api/windows.ui.input.gesturerecognizer.showgesturefeedback).
- Don't use touch visualizations in situations where they might interfere with the use of the app. For more info, see [**ShowGestureFeedback**](/windows/windows-app-sdk/api/winrt/microsoft.ui.input.gesturerecognizer.showgesturefeedback).
- Don't display feedback unless it is absolutely necessary. Keep the UI clean and uncluttered by not showing visual feedback unless you are adding value that is not available elsewhere.
- Try not to dramatically customize the visual feedback behaviors of the built-in Windows gestures, as this can create an inconsistent and confusing user experience.

Expand All @@ -43,7 +43,7 @@ Using the default XAML platform controls available ensures that your app works c

Visual feedback is generally dependent on the input device (touch, touchpad, mouse, pen/stylus, keyboard, and so on). For example, the built-in feedback for a mouse usually involves moving and changing the cursor, while touch and pen require contact visualizations, and keyboard input and navigation uses focus rectangles and highlighting.

Use [**ShowGestureFeedback**](/uwp/api/windows.ui.input.gesturerecognizer.showgesturefeedback) to set feedback behavior for the platform gestures.
Use [**ShowGestureFeedback**](/windows/windows-app-sdk/api/winrt/microsoft.ui.input.gesturerecognizer.showgesturefeedback) to set feedback behavior for the platform gestures.

If customizing feedback UI, ensure you provide feedback that supports, and is suitable for, all input modes.

Expand Down
94 changes: 47 additions & 47 deletions hub/apps/develop/input/handle-pointer-input.md

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions hub/apps/develop/input/identify-input-devices.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ ms.localizationpriority: medium

Identify the input devices connected to a Windows app device and identify their capabilities and attributes.

> **Important APIs**: [**Windows.Devices.Input**](/uwp/api/Windows.Devices.Input), [**Windows.UI.Input**](/uwp/api/Windows.UI.Core), [**Windows.UI.Xaml.Input**](/uwp/api/Windows.UI.Input)
> **Important APIs**: [**Windows.Devices.Input**](/uwp/api/Windows.Devices.Input), [**Windows.UI.Input**](/uwp/api/Windows.UI.Input), [**Windows.UI.Xaml.Input**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Input)

## Retrieve mouse properties

Expand All @@ -27,7 +27,7 @@ The [**Windows.Devices.Input**](/uwp/api/Windows.Devices.Input) namespace contai



The following code uses a series of [**TextBlock**](/uwp/api/Windows.UI.Xaml.Controls.TextBlock) elements to display the individual mouse properties and values.
The following code uses a series of [**TextBlock**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Controls.TextBlock) elements to display the individual mouse properties and values.

```CSharp
private void GetMouseProperties()
Expand All @@ -46,7 +46,7 @@ private void GetMouseProperties()

The [**Windows.Devices.Input**](/uwp/api/Windows.Devices.Input) namespace contains the [**KeyboardCapabilities**](/uwp/api/Windows.Devices.Input.KeyboardCapabilities) class used to retrieve whether a keyboard is connected. Just create a new **KeyboardCapabilities** object and get the [**KeyboardPresent**](/uwp/api/windows.devices.input.keyboardcapabilities.keyboardpresent) property.

The following code uses a [**TextBlock**](/uwp/api/Windows.UI.Xaml.Controls.TextBlock) element to display the keyboard property and value.
The following code uses a [**TextBlock**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Controls.TextBlock) element to display the keyboard property and value.

```CSharp
private void GetKeyboardProperties()
Expand All @@ -65,7 +65,7 @@ The [**Windows.Devices.Input**](/uwp/api/Windows.Devices.Input) namespace contai



The following code uses a series of [**TextBlock**](/uwp/api/Windows.UI.Xaml.Controls.TextBlock) elements to display the touch properties and values.
The following code uses a series of [**TextBlock**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Controls.TextBlock) elements to display the touch properties and values.

```CSharp
private void GetTouchProperties()
Expand Down
Loading