SftTree/OCX 7.5 - ActiveX Tree Control

Edit Method, SftTreeCell Object

Edits the cell.

Syntax

object

A SftTreeCell object.

Window

A window handle. Defines the control used for cell editing. This parameter can be Nothing (NULL) to allow the EditInitializing event to provide the window handle used for cell editing (which is also the preferred method).

vData

An application-specific value. This value is used as vData parameter for the EditInitializing event. This parameter can be Nothing (NULL).

Comments

The Edit method edits the cell.

Cell editing is initiated by the subsequent EditInitializing event which is used to position and initialize the control used for cell editing.

The Edit method cannot edit a cell whose Cell.EditIgnore or Item.EditIgnore properties have marked the cell as non-editable or if the EditAllowed event indicates that the cell cannot be reached during cell editing.

Examples

VB.NET

    End Sub

    Private Sub AxSftTree1_ItemClick(ByVal sender As Object, ByVal e As AxSftTreeLib75._DSftTreeEvents_ItemClickEvent) Handles AxSftTree1.ItemClick
        Dim Img As SftPictureObject
        Dim AreaType As SftTreeAreaTypeConstants
        AreaType = e.areaType
        If AreaType = SftTreeAreaTypeConstants.constSftTreeCellText Then
            ' User clicked on a cell
           AxSftTree1.get_Cell(e.itemIndex, e.colIndex).Edit(0, 0)
        ElseIf AreaType = SftTreeAreaTypeConstants.constSftTreeCellGraphic Then
           ' check if check box - toggle
           Img = AxSftTree1.get_Cell(e.itemIndex, e.colIndex).Image
           If Img.Appearance = SftPictureImageConstants.sftImageCheckboxNo Then
               Img.Appearance = SftPictureImageConstants.sftImageCheckboxYes
           ElseIf Img.Appearance = SftPictureImageConstants.sftImageCheckboxYes Then
               Img.Appearance = SftPictureImageConstants.sftImageCheckboxNo

View Entire Sample Code

VB6

    SftTree1.RowHeaders.MakeOptimal
    SftTree1.Items.RecalcHorizontalExtent

End Sub

Private Sub SftTree1_ItemClick(ByVal ItemIndex As Long, ByVal ColIndex As Integer, ByVal AreaType As Integer, ByVal Button As Integer, ByVal Shift As Integer)
    If AreaType = constSftTreeCellText Then
        ' User clicked on a cell
        SftTree1.Cell(ItemIndex, ColIndex).Edit 0, 0
    ElseIf AreaType = constSftTreeCellGraphic Then
        ' check if check box - toggle
        Dim Img As SftPictureObject
        Set Img = SftTree1.Cell(ItemIndex, ColIndex).Image
        If Img.Appearance = sftImageCheckboxNo Then
            Img.Appearance = sftImageCheckboxYes
        ElseIf Img.Appearance = sftImageCheckboxYes Then

View Entire Sample Code

C#

            axSftTree1.Items.RecalcHorizontalExtent();
        }

        private void axSftTree1_ItemClick(object sender, AxSftTreeLib75._DSftTreeEvents_ItemClickEvent e) {
            SftPictureObject Img;
            SftTreeAreaTypeConstants area = (SftTreeAreaTypeConstants) e.areaType;
            if (area == SftTreeAreaTypeConstants.constSftTreeCellText)
                // User clicked on a cell
                axSftTree1.get_Cell(e.itemIndex, e.colIndex).Edit(0, 0);
            else if (area == SftTreeAreaTypeConstants.constSftTreeCellGraphic) {
                // check if check box - toggle
                Img = axSftTree1.get_Cell(e.itemIndex, e.colIndex).Image;
                if (Img.Appearance == SftPictureImageConstants.sftImageCheckboxNo)
                    Img.Appearance = SftPictureImageConstants.sftImageCheckboxYes;
                else if (Img.Appearance == SftPictureImageConstants.sftImageCheckboxYes)
                    Img.Appearance = SftPictureImageConstants.sftImageCheckboxNo;

View Entire Sample Code

C++

HCURSOR CCellEditingDlg::OnQueryDragIcon()
{
    return (HCURSOR) m_hIcon;
}

void CCellEditingDlg::OnItemClickSftTree1(long ItemIndex, short ColIndex, short AreaType, short Button, short Shift)
{
    if (AreaType == constSftTreeCellText) {
        m_vTree->Cell[ItemIndex][ColIndex]->Edit(NULL, _variant_t(0L));
    } else if (AreaType == constSftTreeCellGraphic) {
        // check if check box - toggle
        ISftPictureObjectPtr pImg;
        pImg = m_vTree->Cell[ItemIndex][ColIndex]->Image;
        if (pImg->Appearance == sftImageCheckboxNo)
            pImg->Appearance = sftImageCheckboxYes;
        else if (pImg->Appearance == sftImageCheckboxYes)

View Entire Sample Code

See Also SftTreeCell Object | Object Hierarchy