event OLEStartDrag (Data as ExDataObject, AllowedEffects as Long)
Occurs when the OLEDrag method is called.

 TypeDescription 
   Data as ExDataObject An ExDataObject object containing formats that the source will provide and, optionally, the data for those formats. If no data is contained in the ExDataObject, it is provided when the control calls the GetData method. The programmer should provide the values for this parameter in this event. The SetData and Clear methods cannot be used here.  
   AllowedEffects as Long A long containing the effects that the source component supports. The possible values are listed in Settings. The programmer should provide the values for this parameter in this event.  
The settings for AllowEffects are:

The source component should logically Or together the supported values and places the result in the AllowedEffects parameter. The target component can use this value to determine the appropriate action (and what the appropriate user feedback should be).
You may wish to defer putting data into the ExDataObject object until the target component requests it. This allows the source component to save time.  If the user does not load any formats into the ExDataObject, then the drag/drop operation is canceled. 

To start accepting drag and drop sources the exGrid control should have the OLEDropMode to exOLEDropManual or exOLEDropAutomatic.

The following VB sample puts the selected text to the clipboard when the drag and drop operation starts ( The OLEDropMode property is exOLEDropManual ):

Private Sub Edit1_OLEStartDrag(ByVal Data As EXEDITLibCtl.IExDataObject, AllowedEffects As Long)
    Dim s As String
    s = Edit1.SelText
    If (Len(s) > 0) Then
        AllowedEffects = 1
        Data.SetData s, 1
    End If
End Sub

The following C++ sample puts the selected text to the clipboard when the drag and drop operation starts:

void OnOLEStartDragEdit1(LPDISPATCH Data, long FAR* AllowedEffects) 
{
	CString s( m_edit.GetSelText() );
	if ( s.GetLength() > 0 )
	{
		*AllowedEffects = 1; /*exOLEDropEffectCopy*/
		if ( EXEDITLib::IExDataObjectPtr spData( Data ) )
			spData->SetData( COleVariant( s ), COleVariant( long(EXEDITLib::exCFText) ) );
		
	}
}

The C++ sample uses the #import <exedit.dll> statement to include definitions for the IExDataObject and IExDataObjectFiles objects.

The following VB.NET sample puts the selected text to the clipboard when the drag and drop operation starts:

Private Sub AxEdit1_OLEStartDrag(ByVal sender As Object, ByVal e As AxEXEDITLib._IEditEvents_OLEStartDragEvent) Handles AxEdit1.OLEStartDrag
    Dim s As String = AxEdit1.SelText
    If (Len(s) > 0) Then
        e.allowedEffects = 1
        e.data.SetData(s, 1)
    End If
End Sub

The following C# sample puts the selected text to the clipboard when the drag and drop operation starts:

private void axEdit1_OLEStartDrag(object sender, AxEXEDITLib._IEditEvents_OLEStartDragEvent e)
{
	string s = axEdit1.SelText;
	if (s.Length > 0)
	{
		e.allowedEffects = 1;
		e.data.SetData(s, EXEDITLib.exClipboardFormatEnum.exCFText );
	}
}

The following VFP sample puts the selected text to the clipboard when the drag and drop operation starts:

*** ActiveX Control Event ***
LPARAMETERS data, allowedeffects

with thisform.Edit1
	local s
	s = .SelText
	if ( len(s) > 0 ) then 
		allowedeffects = 1
		data.SetData( s, 1 )
	endif
endwith

 


Send comments on this topic.
© 1999-2008 Exontrol Inc, Software. All rights reserved.