PMF_SUPPRESS Option

The PMF_SUPPRESS option allows you to control the playing of the metafile. The PMF_SUPPRESS option can have one of the values shown in the following table.

PMF_SUPPRESS Options for GpiPlayMetaFile

┌────────────────┬────────────────────────────────────────────┐
│Value           │Description                                 │
├────────────────┼────────────────────────────────────────────┤
│SUP_SUPPRESS    │The operating system does not draw the      │
│                │metafile on the device associated with the  │
│                │presentation space. This option is useful if│
│                │you need to alter the presentation space    │
│                │before drawing it on an output device.      │
├────────────────┼────────────────────────────────────────────┤
│SUP_NOSUPPRESS  │The operating system draws the metafile on  │
│SUP_DEFAULT     │the device associated with the presentation │
│                │space.                                      │
└────────────────┴────────────────────────────────────────────┘

You can use the RES_RESET option to reinitialize the presentation space and modify certain resources or presentation space environmental attributes from the application before playing the remainder of the metafile by:

• Saving the current state of the presentation space by calling GpiSavePS.

  Use this function only if you wish to restore the previous state of the presentation space after playing the metafile.

• Calling GpiPlayMetaFile and specifying:

  • The PMF_RESET option with the value RES_RESET
    
  • The PMF_SUPPRESS option with the value SUP_SUPPRESS
  This causes GpiPlayMetaFile to set the presentation space to the specifications recorded in the metafile but not to play the picture in the metafile.

Making any required changes to the presentation space.

Calling GpiPlayMetaFile and specifying:

• The PMF_RESET option with the value RES_NORESET
  
• The PMF_SUPPRESS option with the value SUP_NOSUPPRESS
This causes the picture to play.

Restoring the state of the presentation space after playing the metafile by calling GpiRestorePS.