Form.TopMost Propriedade

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 de Propriedade

true para exibir a forma como a forma mais alta; caso contrário, false. A predefinição é false.

Exemplos

O exemplo seguinte demonstra como criar uma forma superior. O exemplo cria duas formas, uma que é maximizada e outra que será exibida como forma superior. A primeira forma, chamada bottomForm, é exibida maximizada, usando a WindowState propriedade, para demonstrar melhor as capacidades da forma superior. A segunda forma, chamada topMostForm, define a TopMost propriedade para true mostrar a forma como uma forma superior. Quando este código é executado, clicar na forma maximizada não fará com que a forma mais alta seja exibida abaixo da forma maximizada. O exemplo exige que o método definido no exemplo seja chamado de outra forma.

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

Observações

Uma forma topo é uma forma que se sobrepõe a todas as outras formas (não topos), mesmo que não seja a forma ativa ou em primeiro plano. As formas mais altas são sempre exibidas no ponto mais alto da ordem z das janelas do ambiente de trabalho. Pode usar esta propriedade para criar um formulário que esteja sempre apresentado na sua aplicação, como uma janela da ferramenta Encontrar e Substituir.

Ver também

• TopLevel