Name

---

  MGH_PRINTER

Purpose

---

  Support a session-wide Object Graphics printer.

Category

---

  Widgets.

Calling Sequence

---

  There are 2 modes of operation:
  1: Return a reference to the session-wide printer object, after
  creating it if necessary:
      obj = MGH_PRINTER()
  2: Set up the printer
      int = MGH_PRINTER(/SETUP)

Positional Parameters

---

  None

Keyword Parameters

---

  SETUP
    If this keyword is set, run DIALOG_PRINTERSETUP and return the
    result.

Return Value

---

  The function returns an object reference, or if SETUP is set, an
  integer representing the completion status of DIALOG_PRINTERSETUP.

Side Effects

---

  A new system variable, !mgh_printer, is created and an
  IDLgrPrinter object reference is stored in it.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History

---

  Mark Hadfield, 2001-06:
    Written.
  Mark Hadfield, 2004-06:
    Updated.