Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  CPoint SetViewportOrg( int x, int y );
  CPoint SetViewportOrg( POINT point );
 
  Parameter   Description
 
  <x>         Specifies the x-coordinate (in device units) of the origin
              of the viewport. The value must be within the range of the
              device coordinate system.
 
  <y>         Specifies the y-coordinate (in device units) of the origin
              of the viewport. The value must be within the range of the
              device coordinate system.
 
  <point>     Specifies the origin of the viewport. The values must be
              within the range of the device coordinate system. You can
              pass either a ◄POINT► structure or a ◄CPoint► object for
              this parameter.
 
  Remarks
 
  Sets the viewport origin of the device context. The viewport, along with
  the device-context window, defines how GDI maps points in the logical
  coordinate system to points in the coordinate system of the actual
  device. In other words, they define how GDI converts logical coordinates
  into device coordinates.
 
  The viewport origin marks the point in the device coordinate system to
  which GDI maps the window origin, a point in the logical coordinate
  system specified by SetWindowOrg. GDI maps all other points by following
  the same process required to map the window origin to the viewport
  origin. For example, all points in a circle around the point at the
  window origin will be in a circle around the point at the viewport
  origin. Similarly, all points in a line that passes through the window
  origin will be in a line that passes through the viewport origin.
 
  Return Value
 
  The previous origin of the viewport (in device coordinates) as a
  ◄CPoint► object.
 
  See Also
 
  ◄CDC::SetWindowOrg►, ◄::SetViewportOrg►
 
 
                                     -♦-