다음을 통해 공유


Control.SetTopLevel 메서드

컨트롤을 최상위 컨트롤로 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
Protected Sub SetTopLevel ( _
    value As Boolean _
)
‘사용 방법
Dim value As Boolean

Me.SetTopLevel(value)
protected void SetTopLevel (
    bool value
)
protected:
void SetTopLevel (
    bool value
)
protected void SetTopLevel (
    boolean value
)
protected function SetTopLevel (
    value : boolean
)

매개 변수

  • value
    컨트롤을 최상위 컨트롤로 설정하려면 true이고, 그렇지 않으면 false입니다.

예외

예외 형식 조건

InvalidOperationException

value 매개 변수가 true로 설정되고 해당 컨트롤이 ActiveX 컨트롤인 경우

Exception

GetTopLevel 반환 값이 value 매개 변수와 같지 않고 Parent 속성이 Null 참조(Visual Basic의 경우 Nothing)이 아닌 경우

설명

FormSetTopLevel 메서드를 호출하고 false 값을 전달하면, true 값을 전달하여 SetTopLevel을 다시 호출할 때까지 폼이 표시되지 않습니다.

.NET Framework 보안

  • UIPermission  컨트롤이 Form 형식인 경우 해당 컨트롤을 최상위 컨트롤로 설정하는 데 필요한 권한입니다. 이 권한은 value 매개 변수가 true이고 해당 컨트롤이 ActiveX 컨트롤이 아닌 경우에만 필요합니다. 연관된 열거형: UIPermissionWindowSafeTopLevelWindows
  • UIPermission  컨트롤이 Form이 아닌 다른 형식인 경우 해당 컨트롤을 최상위 컨트롤로 설정하는 데 필요한 권한입니다. 이 권한은 value 매개 변수가 true이고 해당 컨트롤이 ActiveX 컨트롤이 아닌 경우에만 필요합니다. 연관된 열거형: UIPermissionWindowAllWindows

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

Control 클래스
Control 멤버
System.Windows.Forms 네임스페이스
GetTopLevel