SftTree/OCX 7.5 - ActiveX Tree Control

ItemDblClick Event, SftTree Object

A mouse button is double-clicked.

Syntax

object

A SftTree object.

ItemIndex

The zero-based index of the item at the mouse-cursor location when the mouse button was double-clicked. If the area described by AreaType doesn't require item information, this value is undefined.

ColIndex

The column number of the cell at the mouse-cursor location when the mouse button was double-clicked. If the area described by AreaType doesn't require column information, this value is undefined.

AreaType

Defines the area where the mouse button was double-clicked (see SftTreeAreaTypeConstants).

Button

The button that is pressed during the event (see SftTreeButtonConstants). The button argument is a bit field with bits corresponding to the left button, right button and middle button. These bits correspond to the values shown below. Only one of the bits is set, indicating the button that caused the event.

Shift

The state of the SHIFT, CONTROL and ALT keys during the event (see SftTreeKeyConstants). A bit is set if the key is down. The Shift argument is a bit field with bits corresponding to the SHIFT, CONTROL and ALT keys. The Shift variable indicates the state of these keys. Some, all, or none of the bits can be set, indicating which of the keys are pressed.

Comments

The ItemDblClick event occurs when a mouse button is double-clicked.

¹⁾ Depending on the settings of the LeftButtonOnly or LeftItemClickOnly properties, this event may not be generated for the middle and right mouse buttons.

²⁾ If the AutoRespond property is set to True, the areas constSftTreeLabel, constSftTreePlusMinus, constSftTreeButton, constSftTreeItem and constSftTreeText do not generate an ItemDblClick event for the left mouse button. The tree control responds by expanding/collapsing the item automatically. The middle and right mouse buttons still generate the event in those areas.

The ItemDblClick event supplies all the necessary information to the application, so appropriate action can be taken. The application can start cell editing, expand or collapse an item or display application specific information based on the event and the area double-clicked.

The ItemClick event can be used to respond to a single mouse button click.

If the ItemDblClick event is used to display a context sensitive menu (popup menu), the CancelMode method must be used before displaying the context menu.

Examples

VB.NET

            ToggleImage(AxSftTree1.get_Cell(e.itemIndex, e.colIndex).Image)
        ElseIf AreaType = SftTreeAreaTypeConstants.constSftTreeItem Then
            ToggleImage(AxSftTree1.get_Item(e.itemIndex).Image)
        ElseIf AreaType = SftTreeAreaTypeConstants.constSftTreeLabel Then
            ToggleImage(AxSftTree1.get_Item(e.itemIndex).LabelImage)
        End If
    End Sub

    Private Sub AxSftTree1_ItemDblClick(ByVal sender As Object, ByVal e As AxSftTreeLib75._DSftTreeEvents_ItemDblClickEvent) Handles AxSftTree1.ItemDblClick
        Dim AreaType As SftTreeAreaTypeConstants
        AreaType = e.areaType
        If AreaType = SftTreeAreaTypeConstants.constSftTreeColumnRes Then
            AxSftTree1.get_Column(e.colIndex).MakeOptimal() ' Make column width optimal
            AxSftTree1.Items.RecalcHorizontalExtent() ' Update horizontal scroll bar
        ElseIf AreaType = SftTreeAreaTypeConstants.constSftTreeColumn And e.colIndex = 0 Then
            SetSortDirection(Not m_SortDirection)

View Entire Sample Code

VB6

        ToggleImage SftTree1.Cell(ItemIndex, ColIndex).Image
    ElseIf Area = constSftTreeItem Then
        ToggleImage SftTree1.Item(ItemIndex).Image
    ElseIf Area = constSftTreeLabel Then
        ToggleImage SftTree1.Item(ItemIndex).LabelImage
    End If
End Sub

Private Sub SftTree1_ItemDblClick(ByVal ItemIndex As Long, ByVal ColIndex As Integer, ByVal AreaType As Integer, ByVal Button As Integer, ByVal Shift As Integer)
    Dim Area As SftTreeAreaTypeConstants
    Area = AreaType
    If Area = constSftTreeColumnRes Then
        SftTree1.Column(ColIndex).MakeOptimal ' Make column width optimal
        SftTree1.Items.RecalcHorizontalExtent ' Update horizontal scroll bar
    ElseIf Area = constSftTreeColumn And ColIndex = 0 Then
        SetSortDirection Not SortDirection

View Entire Sample Code

C#

            else if (areaType == SftTreeAreaTypeConstants.constSftTreeCellGraphic)
                ToggleImage(axSftTree1.get_Cell(e.itemIndex, e.colIndex).Image);
            else if (areaType == SftTreeAreaTypeConstants.constSftTreeItem)
                ToggleImage(axSftTree1.get_Item(e.itemIndex).Image);
            else if (areaType == SftTreeAreaTypeConstants.constSftTreeLabel)
                ToggleImage(axSftTree1.get_Item(e.itemIndex).LabelImage);
        }

        private void axSftTree1_ItemDblClick(object sender, AxSftTreeLib75._DSftTreeEvents_ItemDblClickEvent e) {
            SftTreeAreaTypeConstants areaType = (SftTreeAreaTypeConstants) e.areaType;
            if (areaType == SftTreeAreaTypeConstants.constSftTreeColumnRes) {
                axSftTree1.get_Column(e.colIndex).MakeOptimal(); // Make column width optimal
                axSftTree1.Items.RecalcHorizontalExtent(); // Update horizontal scroll bar
            } else if (areaType == SftTreeAreaTypeConstants.constSftTreeColumn && e.colIndex == 0)
                SetSortDirection(!m_SortDirection);
            else if (areaType == SftTreeAreaTypeConstants.constSftTreeCellGraphic)

View Entire Sample Code

C++

    else if (AreaType == constSftTreeCellGraphic)
        ToggleImage(m_vTree->Cell[ItemIndex][ColIndex]->Image);
    else if (AreaType == constSftTreeItem)
        ToggleImage(m_vTree->Item[ItemIndex]->Image);
    else if (AreaType == constSftTreeLabel)
        ToggleImage(m_vTree->Item[ItemIndex]->LabelImage);
}

void CPicturesDlg::OnItemDblClickSftTree1(long ItemIndex, short ColIndex, short AreaType, short Button, short Shift)
{
    if (AreaType == constSftTreeColumnRes) {
        m_vTree->Column[ColIndex]->MakeOptimal(); // Make column width optimal
        m_vTree->Items->RecalcHorizontalExtent(); // Update horizontal scroll bar
    } else if (AreaType == constSftTreeColumn && ColIndex == 0)
        SetSortDirection(!m_fSortDirection);
    else if (AreaType == constSftTreeCellGraphic)

View Entire Sample Code

See Also SftTree Object | Object Hierarchy