HeaderPane
Main
Hide
Share Link
Print

Item Property, DataObjectFiles Object

Returns a specific filename by index from the DataObject.Files collection (sftCFFiles format only).

Syntax

Get

C#string Item = object[int ItemIndex];
VB.NETItem = object.Item(ByVal ItemIndex As Integer) As String
C++_bstr_t Item = object->Item[long ItemIndex];
_bstr_t Item = object->GetItem(long ItemIndex);
CHRESULT object->get_Item(long ItemIndex, BSTR* Item);

object

A DataObjectFiles object.

ItemIndex

The one-based position of the file name to be retrieved.

Item

Returns a specific filename by index from the DataObject.Files collection (sftCFFiles format only).

Comments

The Item property returns a specific filename by index from the DataObject.Files collection (sftCFFiles format only).

This property can be used to retrieve file names from the Files collection.

Examples

VB.NET View entire sample code

    AxSftMask1.OLEDropMode = SftMaskOLEDropModeConstants.OLEDropSftMaskManual
End Sub

Private Sub AxAxSftMask1_OLEDragDrop(ByVal sender As Object, ByVal e As AxSftMaskLib80._ISftMaskEvents_OLEDragDropEvent) Handles AxSftMask1.OLEDragDrop
    If e.data.GetFormat(SftOLEClipboardConstants.sftCFFiles) Then
        If e.data.Files.Count > 1 Then
            MsgBox("Only one file at a time please.")
        Else
            AxSftMask1.Text = e.data.Files.Item(1)
        End If
    End If
End Sub

Private Sub AxAxSftMask1_OLEDragOver(ByVal sender As Object, ByVal e As AxSftMaskLib80._ISftMaskEvents_OLEDragOverEvent) Handles AxSftMask1.OLEDragOver
    If e.targetChar < 0 Then
        ' Outside edit control (on caption)

C++ View entire sample code

void CProject1Dlg::OnOLEDragDropSftMask1(LPDISPATCH FAR* Data, long FAR* TargetChar, long FAR* Effect, short FAR* Button, short FAR* Shift, float FAR* x, float FAR* y)
{
    IVDMDataObjectPtr pData = *Data;

    if (pData->GetFormat(sftCFFiles) != VARIANT_FALSE) {
        if (pData->Files->Count > 1)
            AfxMessageBox(_T("Only one file at a time please."), MB_OK, 0);
        else
            m_pMask1->Text = pData->Files->GetItem(1);
    }
}

void CProject1Dlg::OnOLEDragOverSftMask1(LPDISPATCH FAR* Data, long FAR* TargetChar, long FAR* Effect, short FAR* Button, short FAR* Shift, float FAR* x, float FAR* y, long FAR* State)
{
    IVDMDataObjectPtr pData = *Data;

See Also DataObjectFiles Object | Object Hierarchy


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