![]() | Type | Description | ||
| 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 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