Form.TopMost Form.TopMost Form.TopMost Form.TopMost Property

Определение

Возвращает или задает значение, указывающее, отображать ли форму как форму переднего плана.Gets or sets a value indicating whether the form should be displayed as a topmost form.

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

Значение свойства

Значение true для отображения формы как формы переднего плана; в противном случае — значение false.true to display the form as a topmost form; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере демонстрируется создание самой верхней формы.The following example demonstrates how to create a topmost form. В примере создаются две формы, одна из которых развернута, а другая — как самая верхняя форма.The example creates two forms, one that is maximized and one that will be displayed as a topmost form. Первая форма с именем bottomFormотображается в развернутом виде WindowState с помощью свойства, чтобы лучше продемонстрировать возможности самой верхней формы.The first form, named bottomForm, is displayed maximized, using the WindowState property, to better demonstrate the abilities of the topmost form. Вторая форма с именем topMostForm TopMost задает свойство для true , чтобы отобразить форму в виде самой верхней формы.The second form, named topMostForm, sets the TopMost property to true to display the form as a topmost form. При выполнении этого кода щелчок развернутой формы не приведет к отображению самой верхней формы под развернутой формой.When this code is run, clicking on the maximized form will not cause the topmost form to be displayed below the maximized form. В этом примере требуется, чтобы метод, определенный в примере, вызывался из другой формы.The example requires that the method defined in the example is called from another form.

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

Комментарии

Самая верхняя форма — это форма, которая пересекает все остальные (не самые верхние) формы, даже если она не является активной или основной формой.A topmost form is a form that overlaps all the other (non-topmost) forms even if it is not the active or foreground form. Самые верхние формы всегда отображаются в самой высокой точке z-порядка окон на рабочем столе.Topmost forms are always displayed at the highest point in the z-order of the windows on the desktop. Это свойство можно использовать для создания формы, которая всегда отображается в приложении, например в окне инструментов поиска и замены.You can use this property to create a form that is always displayed in your application, such as a Find and Replace tool window.

Применяется к

Дополнительно