Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MouseWheelParameters.PageTranslation | pageTranslation property

Applies to Windows and Windows Phone

Gets or sets the device-independent pixel (DIP) conversion factors for both page width and height units (as set in the Wheel settings of the Mouse control panel).

Syntax


var pageTranslation = mouseWheelParameters.pageTranslation;
mouseWheelParameters.pageTranslation = pageTranslation;

Property value

Type: Point

The conversion factors for the page width (x) and height (y).

Remarks

The mouse wheel button has discrete, evenly spaced notches or distance thresholds (also called detents). When you rotate or tilt the wheel, a wheel message is sent as each detent is encountered.

The following image shows the default control panel settings for the button wheel. These settings map a single detent to a specific unit of distance in the UI (page width and height). PageTranslation provides the means to redefine these distances and specify the size of a page in terms of DIPs.

Mouse Properties dialog with wheel settings displayed

If the wheel button is set to scroll one screen (page) at a time for each detent and the value of PageTranslation is set to (1200,800), vertical scrolling is applied at 1 x 800 DIPs per detent. Horizontal scrolling distance through the mouse tilt wheel is dependent on the value of CharTranslation.

Note  If ManipulationTranslateY/ManipulationTranslateRailsY is disabled and ManipulationTranslateX/ManipulationTranslateRailsX is enabled through GestureSettings then scrolling is applied only along the horizontal axis when the button wheel is rotated or tilted. In the previous example, the result is horizontal scrolling of 1 x 1200 DIPs per detent. Similarly, if ManipulationTranslateY/ManipulationTranslateRailsY is enabled and ManipulationTranslateX/ManipulationTranslateRailsX is disabled through GestureSettings then scrolling is applied only along the vertical axis when the button wheel is rotated or tilted.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.UI.Input
Windows::UI::Input [C++]

Metadata

Windows.winmd

See also

MouseWheelParameters
GestureRecognizer.MouseWheelParameters
CharTranslation

 

 

Show:
© 2014 Microsoft