Control.FromChildHandle Method (System.Windows.Forms)

FromChildHandle Method

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

Control..::.FromChildHandle Method

Retrieves the control that contains the specified handle.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic

Public Shared Function FromChildHandle ( _
    handle As IntPtr _
) As Control

public static Control FromChildHandle(
    IntPtr handle
)

Visual C++

public:
static Control^ FromChildHandle(
    IntPtr handle
)

static member FromChildHandle : 
        handle:IntPtr -> Control

Parameters

handle: Type: System..::.IntPtr
The window handle (HWND) to search for.

Return Value

Type: System.Windows.Forms..::.Control
The Control that represents the control associated with the specified handle; returns nullNothingnullptra null reference (Nothing in Visual Basic) if no control with the specified handle is found.

Remarks

This method searches up the window handle parent chain until it finds a handle that is associated with a control. This method is more reliable than the FromHandle method, because it correctly returns controls that own more than one handle.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET Framework Security

UIPermission
for all windows to call this method. Associated enumeration: AllWindows value of UIPermissionWindow.

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Control Class

System.Windows.Forms Namespace

Handle

Parent