HeaderPane
Main
Hide
Share Link
Print

ActualWidth Property, SftPictureObject Object

Returns the actual width of the image.

Syntax

Get

C#int WPix = object.ActualWidth;
VB.NETWPix = object.ActualWidth As Integer
C++long WPix = object->ActualWidth;
long WPix = object->GetActualWidth();
CHRESULT object->get_ActualWidth(long* WPix);
VBWPix = object.ActualWidth As Long

object

A SftPictureObject object.

WPix

Returns the actual width of the image.

Comments

The ActualWidth property returns the actual width of the image.

The SftPictureObject.Width property returns the desired image width, last defined by the application. The desired width is only used for certain image types (see SftPictureObject.Type).

Examples

C# View entire sample code

            SftPictureObject img;

            itemIndex = axSftTree1.Items.Current;
            if (itemIndex < 0)
                return;

            // don't use images that are too large in the other areas
            img = axSftTree1.get_Cell(itemIndex, 0).Image;
            if (img.ActualHeight <= 20 && img.ActualWidth <= 20) {
                axSftTree1.RowColumnHeader.Image = img;
                axSftTree1.get_Header(1).Image = img;
            } else {
                axSftTree1.RowColumnHeader.Image.Clear();
                axSftTree1.get_Header(1).Image.Clear();
            }
        }

VB.NET View entire sample code

        Dim ItemIndex As Integer
        Dim Img As SftPictureObject

        ItemIndex = AxSftTree1.Items.Current
        If ItemIndex < 0 Then Exit Sub

        ' don't use images that are too large in the other areas
        Img = AxSftTree1.get_Cell(ItemIndex, 0).Image
        If Img.ActualHeight <= 20 And Img.ActualWidth <= 20 Then
            AxSftTree1.RowColumnHeader.Image = Img
            AxSftTree1.get_Header(1).Image = Img
        Else
            AxSftTree1.RowColumnHeader.Image.Clear()
            AxSftTree1.get_Header(1).Image.Clear()
        End If
    End Sub

C++ View entire sample code

    if (m_Tree.m_hWnd)
        m_Tree.MoveWindow(0, 0, cx, cy);
}

void CPicturesDlg::PropagateImage(long ItemIndex, ISftPictureObjectPtr Img)
{
    // don't use images that are too large in the other areas
    if (Img->ActualHeight <= 20 && Img->ActualWidth < 20) {
        m_vTree->Item[ItemIndex]->Image = Img;
        m_vTree->Item[ItemIndex]->LabelImage = Img;
        m_vTree->Item[ItemIndex]->RowHeader->Image = Img;
    }
}

void CPicturesDlg::UpdateBitmap(long ItemIndex, const CBitmap& bmp, SftTreeHAlignConstants Align)
{

VB6 View entire sample code

    Dim ItemIndex As Integer
    Dim Img As SftPictureObject
    
    ItemIndex = SftTree1.Items.Current
    If ItemIndex < 0 Then Exit Sub
    
    ' don't use images that are too large in the other areas
    Set Img = SftTree1.Cell(ItemIndex, 0).Image
    If Img.ActualHeight <= 20 And Img.ActualWidth <= 20 Then
        SftTree1.RowColumnHeader.Image = Img
        SftTree1.Header(1).Image = Img
    Else
        SftTree1.RowColumnHeader.Image.Clear
        SftTree1.Header(1).Image.Clear
    End If
    

See Also SftPictureObject Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.