Picture Property, SftPictureObject Object

Defines the image object using an OLE Picture object (IPictureDisp interface).

Syntax

Get

C#	stdole.IPictureDisp pPictureDisp = object.Picture;
VB.NET	pPictureDisp = object.Picture As stdole.IPictureDisp
C++	IPictureDisp* pPictureDisp = object->GetPicture();
C	HRESULT object->get_Picture(IPictureDisp** pPictureDisp);
VB	Set pPictureDisp = object.Picture As IPictureDisp

Put

C#	void object.let_Picture(stdole.IPictureDisp pPictureDisp);
VB.NET	object.let_Picture(ByVal pPictureDisp As stdole.IPictureDisp)
C++	void object->PutPicture(IPictureDisp* pPictureDisp);
C	HRESULT object->put_Picture(IPictureDisp* pPictureDisp);
VB	object.Picture = pPictureDisp As IPictureDisp

PutRef

C#	stdole.IPictureDisp object.Picture = pPictureDisp;
VB.NET	object.Picture = pPictureDisp As stdole.IPictureDisp
C++	void object->PutRefPicture(IPictureDisp* pPictureDisp);
C	HRESULT object->putref_Picture(IPictureDisp* pPictureDisp);
VB	Set object.Picture = pPictureDisp As IPictureDisp

object

A SftPictureObject object.

pPictureDisp

Defines the image object using an OLE Picture object (IPictureDisp interface). For information about picture properties, please visit the applicable section "Using SftButton/OCX with ...".

Comments

The Picture property defines the image object using an OLE Picture object (IPictureDisp interface).

Typically, .NET applications use the NETImageObject property to define an image, C and C++ applications use BitmapHandle or Image, VB6 and other COM applications use the Picture property.

The SftPictureObject.Type property is set to sftTypeIDispatch. The SftPictureObject.ActualHeight and SftPictureObject.ActualWidth properties reflect the image size.

Examples

C++ View entire sample code

    if (FAILED(hr)) return;

    IPictureDispPtr pPicDisp = pPic;

    ISftPictureObjectPtr pImg1;
    hr = m_vButton3->get_Image1(&pImg1);
    ASSERT(SUCCEEDED(hr));

    hr = pImg1->put_Picture(pPicDisp);
    ASSERT(SUCCEEDED(hr));

    bmp.DeleteObject();
    pPic = NULL;

    if (m_vButton3->Pressed)
        bmp.LoadBitmap(IDB_OFF);

VB6 View entire sample code

Private Sub CloseButton_Click()
    End
End Sub

Private Sub Form_Load()
    With SftButton2
        ' you could set these at design time using the property pages
        Set .Image1Pressed.Picture = PictureOn.Picture
        Set .Image1.Picture = PictureOff.Picture
    End With
End Sub

Private Sub ChangePicture_SftButton3()
    ' Change the pictures based on the button's Pressed status
    With SftButton3
        If .Pressed Then

See Also SftPictureObject Object | Object Hierarchy