Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This enumeration contains values that specify the desired data or view aspect of the object when drawing or getting data.

Syntax 

typedef enum tagDVASPECT { 
  DVASPECT_CONTENT = 1,
  DVASPECT_THUMBNAIL = 2,
  DVASPECT_ICON = 4,
  DVASPECT_DOCPRINT = 8
} DVASPECT;

Elements

DVASPECT_CONTENT

Provides a representation of an object so it can be displayed as an embedded object inside of a container. This value is typically specified for compound document objects. The presentation can be provided for the screen or printer.

DVASPECT_THUMBNAIL

Provides a thumbnail representation of an object so it can be displayed in a browsing tool. The thumbnail is approximately a 120 by 120 pixel, 16-color (recommended) device-independent bitmap potentially wrapped in a metafile.

DVASPECT_ICON

Provides an iconic representation of an object.

DVASPECT_DOCPRINT

Provides a representation of the object on the screen as though it were printed to a printer using the Printcommand from the Filemenu. The described data may represent a sequence of pages.

Remarks

Values of this enumeration are used to define the dwAspectmember of the FORMATETCstructure. Only one DVASPECTvalue can be used to specify a single presentation aspect in a FORMATETCstructure.

The FORMATETCstructure is used in many OLE functions and interface methods that require information on data presentation.

The default value of MiscStatusis used if a subkey corresponding to the specified DVASPECTis not found. To set an OLE control, specify DVASPECT==1. This will cause the following to occur in the registry.

Copy Code 
HKEY_CLASSES_ROOT\CLSID\ . . .\MiscStatus = 1

Requirements

Header wtypes.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

OleDraw
FORMATETC