Control.FromHandle Method (System.Windows.Forms)

FromHandle 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..::.FromHandle Method

Returns the control that is currently associated with the specified handle.

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

Syntax

Visual Basic

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

public static Control FromHandle(
    IntPtr handle
)

Visual C++

public:
static Control^ FromHandle(
    IntPtr handle
)

static member FromHandle : 
        handle:IntPtr -> Control

Parameters

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

Return Value

Type: System.Windows.Forms..::.Control
A 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

Use the FromChildHandle method if you need to return 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