EditInitialized Event, SftTree Object
Cell editing is about to start.
Syntax
| VB.NET | Private Sub object_EditInitialized(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.EditInitialized |
| VB | Private Sub object_EditInitialized(ByVal Window As OLE_HANDLE, ByVal vData As Variant, ByVal EditIndex As Long, ByVal EditCol As Integer, ByVal ParentWindow As OLE_HANDLE, ByVal LeftPix As Long, ByVal TopPix As Long, ByVal WidthPix As Long, ByVal HeightPix As Long, Positioned As Boolean) |
| C#.NET | void object_EditInitialized(object sender, EventArgumentType e); |
| VC++ | void OnEditInitializedobject(OLE_HANDLE Window, const _variant_t& vData, long EditIndex, short EditCol, OLE_HANDLE ParentWindow, long LeftPix, long TopPix, long WidthPix, long HeightPix, VARIANT_BOOL* Positioned); |
| C | HRESULT OnEditInitializedobject(OLE_HANDLE Window, VARIANT vData, long EditIndex, short EditCol, OLE_HANDLE ParentWindow, long LeftPix, long TopPix, long WidthPix, long HeightPix, VARIANT_BOOL* Positioned); |
object
A SftTree object.
Window
The window handle of the control being used for cell editing.
vData
Application-specific data provided as vData argument when Cell.Edit was called.
EditIndex
The zero-based index of the item being edited. The combination of EditIndex and EditCol describes an individual cell.
EditCol
The zero-based column number. The combination of EditIndex and EditCol describes an individual cell.
ParentWindow
The window handle of the window hosting the control used for cell editing.
LeftPix
The x coordinate of the control used for cell editing in pixels. This value was determined and returned by the EditInitializing event.
TopPix
The y coordinate of the control used for cell editing in pixels. This value was determined and returned by the EditInitializing event.
WidthPix
The width of the control used for cell editing in pixels. This value was determined and returned by the EditInitializing event.
HeightPix
The height of the control used for cell editing in pixels. This value was determined and returned by the EditInitializing event.
Positioned
Return True if the control used for cell editing was positioned by the application in the EditInitialized event. The application also must make the control visible, enabled and set the input focus to the control.
If False is returned, the tree control will position the control, enable the control, make it visible and set the input focus to the control.
Comments
The EditInitialized event occurs when cell editing is about to start.
Cell editing is about to start. The EditInitializing event, which precedes the EditInitialized event, has initialized a control for cell editing (described by the Window argument).
This event can be used to perform final control initialization. The control's position and dimension can be set, based on the LeftPix, TopPix, WidthPix, HeightPix arguments. The application also must make the control visible, enabled and set the input focus to the control. If Positioned is set to False, the tree control will automatically position the control used for cell editing, make the control visible, enabled and set the input focus to the control. However, many environments (including .NET) and ActiveX controls require that the application make controls visible and enabled explicitly.
Additional final customizations can be performed. For example, when a combo box is used, this event can drop down the dropdown portion of the edit control.
This event should not be used to otherwise initialize a control used for cell editing, nor should the tree control manipulated or updated in any way.
Examples
VB.NET
' We want these keys just for the edit control.
' VK_UP
AxSftTree1.CellEditIntercept(38, SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeChar Or SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeControlChar Or SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeShiftChar)
' VK_DOWN
AxSftTree1.CellEditIntercept(40, SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeChar Or SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeControlChar Or SftTreeCellEditInterceptStyleConstants.cellEditInterceptSftTreeShiftChar)
End If
End Sub
Private Sub AxSftTree1_EditInitialized(ByVal sender As Object, ByVal e As AxSftTreeLib80._DSftTreeEvents_EditInitializedEvent) Handles AxSftTree1.EditInitialized
' Show the combo box dropdown portion
If e.vData Is Combo1 Then
' We're taking over positioning, so we can drop down the dropdown portion of the control
e.positioned = True
Combo1.Left = e.leftPix
Combo1.Top = e.topPix
Combo1.Width = e.widthPix View Entire Sample Code
C++
BEGIN_EVENTSINK_MAP(CCellEditingDlg, CDialog)
//{{AFX_EVENTSINK_MAP(CCellEditingDlg)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 4 /* ItemClick */, OnItemClickSftTree1, VTS_I4 VTS_I2 VTS_I2 VTS_I2 VTS_I2)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 5 /* ItemDblClick */, OnItemDblClickSftTree1, VTS_I4 VTS_I2 VTS_I2 VTS_I2 VTS_I2)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 28 /* ToolTipVScroll */, OnToolTipVScrollSftTree1, VTS_PBSTR VTS_I4 VTS_I2)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 44 /* EditAllowed */, OnEditAllowedSftTree1, VTS_I4 VTS_I2 VTS_PBOOL)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 38 /* EditInitializing */, OnEditInitializingSftTree1, VTS_PI4 VTS_PVARIANT VTS_I4 VTS_I2 VTS_PI4 VTS_PI4 VTS_PI4 VTS_PI4)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 39 /* EditInitialized */, OnEditInitializedSftTree1, VTS_I4 VTS_VARIANT VTS_I4 VTS_I2 VTS_I4 VTS_I4 VTS_I4 VTS_I4 VTS_I4 VTS_PBOOL)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 43 /* EditNavigating */, OnEditNavigatingSftTree1, VTS_I4 VTS_I2 VTS_I4 VTS_I2)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 37 /* EditValidate */, OnEditValidateSftTree1, VTS_I4 VTS_VARIANT VTS_I4 VTS_I2 VTS_PBOOL)
ON_EVENT(CCellEditingDlg, IDC_SFTTREE1, 36 /* EditEnding */, OnEditEndingSftTree1, VTS_I4 VTS_VARIANT VTS_I4 VTS_I2 VTS_BOOL)
//}}AFX_EVENTSINK_MAP
END_EVENTSINK_MAP()
BOOL CCellEditingDlg::OnWndMsg(UINT message, WPARAM wParam, LPARAM lParam, LRESULT* pResult)
{ View Entire Sample Code
See Also SftTree Object | Object Hierarchy
On
Off