Control.SetTopLevel(Boolean) Control.SetTopLevel(Boolean) Control.SetTopLevel(Boolean) Control.SetTopLevel(Boolean) Method

Definição

Namespace:
System.Windows.Forms System.Windows.Forms System.Windows.Forms System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Define o controle como o controle de nível superior.Sets the control as the top-level control.

protected:
 void SetTopLevel(bool value);
protected void SetTopLevel (bool value);
member this.SetTopLevel : bool -> unit
Protected Sub SetTopLevel (value As Boolean)

Parâmetros

value
Boolean Boolean Boolean Boolean

true para definir o controle como o controle de nível superior; caso contrário, false.true to set the control as the top-level control; otherwise, false.

Exceções

InvalidOperationException InvalidOperationException InvalidOperationException InvalidOperationException

O parâmetro value está definido como true e o controle é um controle ActiveX.The value parameter is set to true and the control is an ActiveX control.

Exception Exception Exception Exception

O valor retornado GetTopLevel() não é igual ao parâmetro value e a propriedade Parent não é null.The GetTopLevel() return value is not equal to the value parameter and the Parent property is not null.

Comentários

Se você chamar o SetTopLevel método de a Form e passar um valor de false, o formulário não estará visível até que você chame SetTopLevel novamente, passando um valor de true.If you call the SetTopLevel method of a Form and pass in a value of false, the form will not be visible until you call SetTopLevel again, passing in a value of true.

Segurança

UIPermission
para definir o controle como um controle de nível superior, se ele for de qualquer tipo diferente Formde.to set the control as a top-level control if it is of any type other than Form. Essa permissão só será solicitada se o value parâmetro for true e o controle não for um controle ActiveX.This permission is only demanded if the value parameter is true and the control is not an ActiveX control. Enumeração associada: AllWindows valor de UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

Aplica-se a

Veja também