PixelSizeAdjustments.FromCurrentDpi Methods
Factory method to initialize a new PixelSizeAdjustments instance to match the current display DPI.
Overload List
| Name | Description | |
|---|---|---|
 Public method | FromCurrentDpi() | Factory method to initialize a new PixelSizeAdjustments instance to match the current display DPI. |
| Public method | FromCurrentDpi(System.Double viewingDistance) | Factory method to initialize a new PixelSizeAdjustments instance to match the current display DPI and an estimated viewing distance. |
FromCurrentDpi()
Factory method to initialize a new PixelSizeAdjustments instance to match the current display DPI.Syntax
public static PixelSizeAdjustments FromCurrentDpi ()Return Value
Remarks
This method can be used by an application to initialize a PixelSizeAdjustments instance, with scale factors suitable for the current display. Use the Drawable.PixelSizeAdjustments property to apply the adjustments, after retrieving the view from a loaded configuration, but before attaching to the MapControl.
This method assumes that the configuration is designed for a standard 96 DPI desktop monitor. The adjustment factors will be calculated using this assumption and the current display resolution, as returned by Drawable.ScreenPixelSize.
The calculated scale factors are based on a simple formula that should work reasonably well in most cases. If the application needs finer control, it can modify the individual values in the returned instance, before attaching it to the drawable.
Note that the FromCurrentDpi overload also lets the application specify an estimated viewing distance. This can be useful if you know that the application will run on a hand-held Android device, which is typically viewed from a shorter distance than a desktop monitor.
FromCurrentDpi(System.Double viewingDistance)
Factory method to initialize a new PixelSizeAdjustments instance to match the current display DPI and an estimated viewing distance.Syntax
public static PixelSizeAdjustments FromCurrentDpi (
System.Double viewingDistance
)Parameters
Estimated viewing distance in meters.
Return Value
Remarks
This method can be used by an application to initialize a PixelSizeAdjustments instance, with scale factors suitable for the current display, and an estimated distance from the user's eyes to the display. Use the Drawable.PixelSizeAdjustments property to apply the adjustments, after retrieving the view from a loaded configuration, but before attaching to the MapControl.
This method assumes that the configuration is designed for a standard 96 DPI desktop monitor and a typical viewing distance of 0.8 meters. The adjustment factors will be calculated using this assumption, the current display resolution as returned by Drawable.ScreenPixelSize, and the specified viewing distance.
For instance, if the application is targeting hand-held Android devices, it should specify a viewing distance of perhaps 0.4 meters, which will reduce the adjustment factors slightly. This will in turn will make font sizes, symbols, line widths etc. a little smaller on the screen.
The calculated scale factors are based on a simple formula that should work reasonably well in most cases. If the application needs finer control, it can modify the individual values in the returned instance, before attaching it to the drawable.
Platforms
Windows, Linux, Android