Defines whether caller-supplied pixel dimensions are scaled to the current DPI.
Get
| C# | SftMaskScalingConstants Mode = object.PixelScaling; |
| VB.NET | Mode = object.PixelScaling As SftMaskScalingConstants |
| C++ | enum SftMaskScalingConstants Mode = object->PixelScaling; enum SftMaskScalingConstants Mode = object->GetPixelScaling(); |
| C | HRESULT object->get_PixelScaling(enum SftMaskScalingConstants* Mode); |
Put
| C# | SftMaskScalingConstants object.PixelScaling = Mode; |
| VB.NET | object.PixelScaling = Mode As SftMaskScalingConstants |
| C++ | enum SftMaskScalingConstants object->PixelScaling = Mode; void object->PutPixelScaling(enum SftMaskScalingConstants Mode); |
| C | HRESULT object->put_PixelScaling(enum SftMaskScalingConstants Mode); |
object
Mode
Defines whether caller-supplied pixel dimensions are scaled to the current DPI.
| Name | Value | Description |
|---|---|---|
| scalingSftMaskAsIs | 0 | Use caller-supplied pixel values verbatim (the default). |
| scalingSftMaskStretch | 1 | Scale caller-supplied pixel values by the current DPI. |
The PixelScaling property defines whether caller-supplied pixel dimensions are scaled to the current DPI.
The setting covers the caption width defined using the Caption.WidthPix and Caption.Width properties. With scalingSftMaskStretch, the width is interpreted as 96-DPI reference pixels: a width of 100 pixels is 100 pixels at 100%, 150 pixels at 150% and 200 pixels at 200% scaling. The property values themselves do not change.
This setting is independent of ImageScaling.
See Also SftMask Object | Object Hierarchy | Per-Monitor DPI and Scaling
On
Off