IOleUIObjInfo::SetViewInfo

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.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oledlg.h.