IOleUIObjInfo::SetViewInfo  1M_XPSA

Sets the view information associated with the object.

HRESULT SetViewInfo(

    DWORD dwObject,

//Unique 32-bit object identifier

    HGLOBAL hMetaPict,

//New icon for the object

    DWORD dvAspect,

//New display aspect for the objec

    int nCurrentScale,

//New scale for the objec

    BOOL bRelativeToOrig

//Scale of the object relative to origin

   );

 

 

Parameters

dwObject

[in] Unique 32-bit identifier for the object.

hMetaPict

[in] New icon for the object.

dvAspect

[in] Object s new display aspect or view.

nCurrentScale

[in] Object s new scale.

bRelativeToOrig

[in] Scale of the object, relative to the origin. This value is TRUE if the new scale should be relative to the original scale of the object. If FALSE, nCurrentScale applies to the object s current size.

 

Return Values

This method supports the standard return values E_FAIL, E_INVALIDARG, and E_OUTOFMEMORY, as well as the following:

S_OK

Successfully returned link information.

E_ACCESSDENIED

Insufficient access permissions.

 

Remarks

Notes To Implementers

You should apply the new attributes (icon, aspect, and scale) to the object. If bRelativeToOrig is set to TRUE, nCurrentScale (in percentage units) applies to the original size of the object before it was scaled. If bRelativeToOrig is FALSE, nCurrentScale applies to the object s current size.

See Also

DVASPECT