DVASPECT enumeration (COM)

Switch View :
ScriptFree
DVASPECT enumeration

Applies to: desktop apps only

Specifies 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;

Constants

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 Print command from the File menu. The described data may represent a sequence of pages.

Remarks

Values of this enumeration are used to define the dwAspect member of the FORMATETC structure. Only one DVASPECT value can be used to specify a single presentation aspect in a FORMATETC structure. The FORMATETC structure is used in many OLE functions and interface methods that require information on data presentation.

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

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

WTypes.h

See also

IAdviseSink
IDataObject
IOleObject
IViewObject
IViewObject2
OleDraw
FORMATETC
OBJECTDESCRIPTOR

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012