SftPicture2 Documentation

Sft_SetPictureNETImage

Store an IUnknown* pointer for a .NET image in a SFT_PICTURE as a SFT_PICTURE_NET slot.

C

void Sft_SetPictureNETImage(LPSFT_PICTURE lpPicture, IUnknown* lpImageObject);

Parameters

lpPicture

Pointer to a SFT_PICTURE. Must not be NULL.

lpImageObject

IUnknown* for a .NET System.Drawing.Image, typically obtained from the .NET-side wrapper via Marshal.GetIUnknownForObject (or its product-specific equivalent). NULL leaves the slot empty.

Comments

Sft_SetPictureNETImage calls Sft_ClearPicture internally before assigning the new pointer.

Reference counting: the SFT_PICTURE stores the raw IUnknown pointer without calling AddRef. The .NET / managed code that supplied the IUnknown is responsible for ensuring the image outlives the SFT_PICTURE.

SFT_PICTURE_NET is intended for hosts that wrap a .NET interop layer around a Softel vdm DLL. The native side stores and renders the image; the .NET side manages the image's lifetime.

See Also SftPicture2 | SFT_PICTURE | SFT_PICTURE_NET | Sft_IsPictureNETImage