### IPresSpaceHandle

  The IPresSpaceHandle class is a wrapper for graphics context or presentation space handles.

#### AIX Considerations

  Use IPresSpaceHandle in system calls where the X Toolkit type GC is required.

#### OS/2 Considerations

  Use IPresSpaceHandle in system calls where the OS/2 Programmer's Toolkit type HPS is required.

#### Windows Considerations

  Use IPresSpaceHandle in system calls where the Win32 Programmer's Toolkit type HDC is required.

### IPresSpaceHandle - Member Functions and Data by Group

### Constructors & Destructor

Use the functions in this group to construct, destroy, and copy objects of this class.

~IPresSpaceHandle

      public:
      ~IPresSpaceHandle()

  Destroys the object of class IPresSpaceHandle.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

IPresSpaceHandle
  This function constructs an object of class IPresSpaceHandle.

  Overload 1

      public:
      IPresSpaceHandle(const IPresSpaceHandle& src)

  Use this constructor to construct an object of this class that is copied from the given one.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      IPresSpaceHandle( Value value = 0,
                        INativeWindowHandle hwnd = 0 )

  Use this constructor to create an object of this class from a presentation space handle (a value of type IPresSpaceHandle::Value), which defaults to 0, and a native window handle, which also defaults to 0.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

operator =

      public:
      IPresSpaceHandle& operator =(const IPresSpaceHandle& src)

  Assigns the value of one graphics context or presentation space handle to another.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Diagnostics

Use the functions in this group to obtain diagnostic information.

asDebugInfo

      public:
      IString asDebugInfo() const

  This function returns the handle as a string containing diagnostic information.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

asString

      public:
      IString asString() const

  This function returns the handle as a string of form nnnn.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

asUnsigned

      public:
      unsigned long asUnsigned() const

  This function returns the handle value as an unsigned long value.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Type Conversions

Use the operator in this group to convert objects of this class to a different type.

operator Value

      public:
      operator Value() const

  Returns the handle as its operating system dependent type. Use this operator when you use the handle object as an argument to an operating system function.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### IPresSpaceHandle - Type Definitions

Value

      typedef unsigned long Value

  Variation 1

      typedef unsigned long Value

Supported Platforms

  Windows | OS/2 | AIX
  No | Yes | No

  Variation 2

      typedef void * Value

Supported Platforms

  Windows | OS/2 | AIX
  Yes | No | No

  Variation 3

      typedef IXDC * Value

Supported Platforms

  Windows | OS/2 | AIX
  No | No | Yes

### IPresSpaceHandle - Inherited Member Functions and Data

#### Inherited Public Functions

  - None

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None