Share via

MouseWheelParameters.CharTranslation Property

  • Reference

Definition

Namespace:
Windows.UI.Input
Edit

Gets or sets the conversion factors for both character width and line height units, in device-independent pixel (DIP).

public:
 property Point CharTranslation { Point get(); void set(Point value); };
Point CharTranslation();

void CharTranslation(Point value);
public Point CharTranslation { get; set; }
var point = mouseWheelParameters.charTranslation;
mouseWheelParameters.charTranslation = point;
Public Property CharTranslation As Point

Property Value

Point

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

Remarks

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 (character width and line height). CharTranslation provides the means to redefine these distances and specify them in terms of device-independent pixel (DIP).

Screenshot of the Mouse Settings page showing mouse wheel scrolling settings.

Mouse properties dialog with wheel settings displayed

If the wheel button is set to scroll three lines at a time for each detent and the value of CharTranslation is set to (8,16), vertical scrolling is applied at 3 x 16 = 48 device-independent pixel (DIP) per detent. Horizontal scrolling through the mouse tilt wheel is applied at 3 x 8 = 24 device-independent pixel (DIP) per detent.

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. 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.

Applies to