Pixel/HIMETRIC Conversion Global Functions

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Pixel-HIMETRIC Conversion Global Functions.

These functions provide support for converting to and from pixel and HIMETRIC units.

Important

The functions listed in the following table cannot be used in applications that execute in the Windows Runtime.

AtlHiMetricToPixel	Converts HIMETRIC units (each unit is 0.01 millimeter) to pixels.
AtlPixelToHiMetric	Converts pixels to HIMETRIC units (each unit is 0.01 millimeter).

AtlHiMetricToPixel

Converts an object's size in HIMETRIC units (each unit is 0.01 millimeter) to a size in pixels on the screen device.

Important

This function cannot be used in applications that execute in the Windows Runtime.

extern void AtlHiMetricToPixel(
  const SIZEL* lpSizeInHiMetric, 
  LPSIZEL lpSizeInPix);

Parameters

lpSizeInHiMetric
[in] Pointer to the size of the object in HIMETRIC units.

lpSizeInPix
[out] Pointer to where the object's size in pixels is to be returned.

Example

   // m_sizeExtent is a member of CComControlBase that holds the 
   // control's extents in HIMETRIC units.
   // Use AtlHiMetricToPixel to find the extent of the control in pixels.
   AtlHiMetricToPixel(&m_sizeExtent, &sz);
   ATLTRACE("Width = %d, Height = %d\n", sz.cx, sz.cy);

AtlPixelToHiMetric

Converts an object's size in pixels on the screen device to a size in HIMETRIC units (each unit is 0.01 millimeter).

Important

This function cannot be used in applications that execute in the Windows Runtime.

extern void AtlPixelToHiMetric(
    const SIZEL* lpSizeInPix, 
    LPSIZEL lpSizeInHiMetric);

Parameters

lpSizeInPix
[in] Pointer to the object's size in pixels.

lpSizeInHiMetric
[out] Pointer to where the object's size in HIMETRIC units is to be returned.

Example

// Initialize our control's default size to 100 by 25 pixels
CMyControl::CMyControl()
{
    // width = 100 pixels, height = 25 pixels
    SIZE sz = { 100, 25 };
    // convert pixels to himetric
    AtlPixelToHiMetric(&sz, &m_sizeExtent);
    // store natural extent
    m_sizeNatural = m_sizeExtent;
}

See Also

Functions