Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Determining the Active MDI Child

Visual Studio .NET 2003

On occasion, you will want to provide a command that operates on the control that has focus on the currently active child form. For example, suppose you want to copy selected text from the child form's text box to the Clipboard. You would create a procedure that copies selected text to the Clipboard using the Click event of the Copy menu item on the standard Edit menu.

Because an MDI application can have many instances of the same child form, the procedure needs to know which form to use. To specify the correct form, use the ActiveMDIChild property, which returns the child form that has the focus or that was most recently active.

When you have several controls on a form, you also need to specify which control is active. Like the ActiveMDIChild property, the ActiveControl property returns the control with the focus on the active child form. The procedure below illustrates a copy procedure that can be called from a child form menu, a menu on the MDI form, or a toolbar button.

To determine the active MDI child (to copy its text to the Clipboard)

Note   This example assumes there is an MDI parent form (
) that has one or more MDI child windows containing a RichTextBox control. For more information, see Creating MDI Parent Forms.
  • Within a method, copy the text of the active control of the active child form to the Clipboard.
    ' Visual Basic
    Public Sub mniCopy_Click(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles mniCopy.Click
       ' Determine the active child form.
       Dim activeChild As Form = Me.ActiveMDIChild
       ' If there is an active child form, find the active control, which
       ' in this example should be a RichTextBox.
       If (Not activeChild Is Nothing) Then
             Dim theBox As RichTextBox = _
             Ctype(activeChild.ActiveControl, RichTextBox)
             If (Not theBox Is Nothing) Then
                ' Put selected text on Clipboard.
             End If
             MessageBox.Show("You need to select a RichTextBox.")
          End Try
       End If
    End Sub
    // C#
    protected void mniCopy_Click (object sender, System.EventArgs e)
       // Determine the active child form.
       Form activeChild = this.ActiveMdiChild;
       // If there is an active child form, find the active control, which
       // in this example should be a RichTextBox.
       if (activeChild != null)
             RichTextBox theBox = (RichTextBox)activeChild.ActiveControl;
             if (theBox != null)
                // Put the selected text on the Clipboard.
             MessageBox.Show("You need to select a RichTextBox.");

See Also

Multiple-Document Interface (MDI) Applications | Creating MDI Parent Forms | Creating MDI Child Forms | Sending Data to the Active MDI Child | Arranging MDI Child Forms

© 2015 Microsoft