Form.TopMost Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o formulário deve ser exibido como o formulário superior.

public:
 property bool TopMost { bool get(); void set(bool value); };

public bool TopMost { get; set; }

member this.TopMost : bool with get, set

Public Property TopMost As Boolean

Valor da propriedade

Boolean

true para exibir o formulário como o formulário superior; caso contrário, false. O padrão é false.

Exemplos

O exemplo a seguir demonstra como criar um formulário superior. O exemplo cria dois formulários, um maximizado e outro que será exibido como uma forma superior. O primeiro formulário, chamado bottomForm, é exibido maximizado, usando a WindowState propriedade , para demonstrar melhor as habilidades da forma mais alta. O segundo formulário, chamado topMostForm, define a TopMost propriedade como true para exibir o formulário como uma forma superior. Quando esse código é executado, clicar no formulário maximizado não fará com que o formulário superior seja exibido abaixo do formulário maximizado. O exemplo requer que o método definido no exemplo seja chamado de outro formulário.

private:
   void CreateMyTopMostForm()
   {
      // Create lower form to display.
      Form^ bottomForm = gcnew Form;

      // Display the lower form Maximized to demonstrate effect of TopMost property.
      bottomForm->WindowState = FormWindowState::Maximized;

      // Display the bottom form.
      bottomForm->Show();

      // Create the top most form.
      Form^ topMostForm = gcnew Form;

      // Set the size of the form larger than the default size.
      topMostForm->Size = System::Drawing::Size( 300, 300 );

      // Set the position of the top most form to center of screen.
      topMostForm->StartPosition = FormStartPosition::CenterScreen;

      // Display the form as top most form.
      topMostForm->TopMost = true;
      topMostForm->Show();
   }

private void CreateMyTopMostForm()
{
   // Create lower form to display.
   Form bottomForm = new Form();
   // Display the lower form Maximized to demonstrate effect of TopMost property.
   bottomForm.WindowState = FormWindowState.Maximized;
   // Display the bottom form.
   bottomForm.Show();
   // Create the top most form.
   Form topMostForm = new Form();
   // Set the size of the form larger than the default size.
   topMostForm.Size = new Size(300,300);
   // Set the position of the top most form to center of screen.
   topMostForm.StartPosition = FormStartPosition.CenterScreen;
   // Display the form as top most form.
   topMostForm.TopMost = true;
   topMostForm.Show();
}

Private Sub CreateMyTopMostForm()
   ' Create lower form to display.
   Dim bottomForm As New Form()
   ' Display the lower form Maximized to demonstrate effect of TopMost property.
   bottomForm.WindowState = FormWindowState.Maximized
   ' Display the bottom form.
   bottomForm.Show()
   ' Create the top most form.
   Dim topMostForm As New Form()
   ' Set the size of the form larger than the default size.
   topMostForm.Size = New Size(300, 300)
   ' Set the position of the top most form to center of screen.
   topMostForm.StartPosition = FormStartPosition.CenterScreen
   ' Display the form as top most form.
   topMostForm.TopMost = True
   topMostForm.Show()
End Sub

Comentários

Uma forma superior é uma forma que se sobrepõe a todas as outras formas (não superiores), mesmo que não seja a forma ativa ou em primeiro plano. As formas mais altas são sempre exibidas no ponto mais alto na ordem z das janelas na área de trabalho. Você pode usar essa propriedade para criar um formulário que sempre é exibido em seu aplicativo, como uma janela de ferramenta Localizar e Substituir.

Confira também

• TopLevel