Freigeben über

Control.SetTopLevel-Methode

  • Artikel

Legt das Steuerelement als Steuerelement der obersten Ebene fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Protected Sub SetTopLevel ( _
    value As Boolean _
)
'Usage
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
)

Parameter

  • value
    true, um das Steuerelement als Steuerelement der obersten Ebene festzulegen, andernfalls false.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Der value-Parameter ist auf true festgelegt, und das Steuerelement ist ein ActiveX-Steuerelement.

Exception

Der GetTopLevel-Rückgabewert ist ungleich dem value-Parameter, und die Parent-Eigenschaft ist nicht NULL (Nothing in Visual Basic).

Hinweise

Wenn Sie die SetTopLevel-Methode eines Form-Objekts aufrufen und den Wert false an die Methode übergeben, bleibt das Formular solange unsichtbar, bis Sie SetTopLevel erneut aufrufen und dabei den Wert true übergeben.

.NET Framework-Sicherheit

  • UIPermission  um das Steuerelement als Steuerelement der obersten Ebene festzulegen, sofern es vom Typ Form ist. Diese Berechtigung wird nur gefordert, wenn der value-Parameter true und das Steuerelement kein ActiveX-Steuerelement ist. Zugeordnete Enumeration: SafeTopLevelWindows-Wert von UIPermissionWindow.
  • UIPermission  zum Festlegen des Steuerelements als Steuerelement der obersten Ebene, sofern es nicht vom Typ Form ist. Diese Berechtigung wird nur gefordert, wenn der value-Parameter true und das Steuerelement kein ActiveX-Steuerelement ist. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
GetTopLevel