HeaderPane
Main
Hide
Share Link
Print

Add Method, DataObjectFiles Object

Adds a filename to the DataObject.Files collection (sftCFFiles format only).

Syntax

C#void object.Add(string Filename, object ItemIndex);
VB.NETobject.Add(ByVal Filename As String, [ ByVal ItemIndex As Object ] )
C++HRESULT object->Add(_bstr_t Filename, const _variant_t& ItemIndex = vtMissing);
CHRESULT object->raw_Add(BSTR Filename, VARIANT ItemIndex);

object

A DataObjectFiles object.

Filename

The file name to be added to the collection.

ItemIndex

The one-based position where the file name is to be inserted. If ItemIndex is not specified, the new file name is added at the end of the collection.

Comments

The Add method adds a filename to the DataObject.Files collection (sftCFFiles format only).

The Files collection is filled with file names only when the DataObject object contains data of type sftCFFiles. The DataObject object can contain several different types of data. You can iterate through the collection to retrieve the list of file names.

Examples

C# View entire sample code

    if (axSftMask1.SelLength != 0) {
        axSftMask1.OLEDrag();
    }
}

private void axSftMask1_OLEStartDrag(object sender, AxSftMaskLib80._ISftMaskEvents_OLEStartDragEvent e)
{
    e.data.Clear();
    e.data.Files.Add(axSftMask1.SelText, null);
    e.data.SetData(null, SftOLEClipboardConstants.sftCFFiles);
    e.allowedEffects = 1; //vbDropEffectCopy
}

VB.NET View entire sample code

Private Sub AxAxSftMask1_DragStarting(ByVal sender As Object, ByVal e As AxSftMaskLib80._ISftMaskEvents_DragStartingEvent) Handles AxSftMask1.DragStarting
    If AxSftMask1.SelLength <> 0 Then
        AxSftMask1.OLEDrag()
    End If
End Sub

Private Sub AxAxSftMask1_OLEStartDrag(ByVal sender As Object, ByVal e As AxSftMaskLib80._ISftMaskEvents_OLEStartDragEvent) Handles AxSftMask1.OLEStartDrag
    e.data.Clear()
    e.data.Files.Add(AxSftMask1.SelText)
    e.data.SetData(Nothing, SftOLEClipboardConstants.sftCFFiles)
    e.allowedEffects = 1 ' vbDropEffectCopy
End Sub

C++ View entire sample code

        m_pMask1->OLEDrag();
    }
}

void CProject1Dlg::OnOLEStartDragSftMask1(LPDISPATCH FAR* Data, long FAR* AllowedEffects)
{
    IVDMDataObjectPtr pData = *Data;
    pData->Clear();
    pData->Files->Add(m_pMask1->SelText);
    pData->SetData(vtMissing, _variant_t((long) sftCFFiles));
    *AllowedEffects = DROPEFFECT_COPY;
}

BEGIN_EVENTSINK_MAP(CProject1Dlg, CDialog)
    //{{AFX_EVENTSINK_MAP(CProject1Dlg)
    ON_EVENT(CProject1Dlg, IDC_SFTMASK1, 10 /* DragStarting */, OnDragStartingSftMask1, VTS_I2 VTS_I2 VTS_R4 VTS_R4)

See Also DataObjectFiles Object | Object Hierarchy


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