Form.StartPosition 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

런타임에 폼의 시작 위치를 가져오거나 설정합니다.

public:
 property System::Windows::Forms::FormStartPosition StartPosition { System::Windows::Forms::FormStartPosition get(); void set(System::Windows::Forms::FormStartPosition value); };

public System.Windows.Forms.FormStartPosition StartPosition { get; set; }

member this.StartPosition : System.Windows.Forms.FormStartPosition with get, set

Public Property StartPosition As FormStartPosition

속성 값

FormStartPosition

폼의 시작 위치를 나타내는 FormStartPosition입니다.

예외

InvalidEnumArgumentException

지정된 값이 유효한 값 범위를 벗어난 경우

예제

다음 예제에서는 a의 새 인스턴스를 Form 만들고 메서드를 ShowDialog 호출하여 폼을 대화 상자로 표시합니다. 이 예제에서는 폼의 FormBorderStyle모양과 StartPosition 기능을 대화 상자로 변경하도록 , AcceptButton및 CancelButton속성을 설정합니다. 이 예제에서는 폼 Controls 컬렉션의 메서드를 사용하여 Add 두 개의 Button 컨트롤을 추가합니다. 이 예제에서는 속성을 사용하여 HelpButton 대화 상자의 캡션 표시줄에 도움말 단추를 표시합니다.

public:
   void CreateMyForm()
   {
      // Create a new instance of the form.
      Form^ form1 = gcnew Form;
      // Create two buttons to use as the accept and cancel buttons.
      Button^ button1 = gcnew Button;
      Button^ button2 = gcnew Button;
      
      // Set the text of button1 to "OK".
      button1->Text = "OK";
      // Set the position of the button on the form.
      button1->Location = Point(10,10);
      // Set the text of button2 to "Cancel".
      button2->Text = "Cancel";
      // Set the position of the button based on the location of button1.
      button2->Location
         = Point( button1->Left, button1->Height + button1->Top + 10 );
      // Set the caption bar text of the form.   
      form1->Text = "My Dialog Box";
      // Display a help button on the form.
      form1->HelpButton = true;
      
      // Define the border style of the form to a dialog box.
      form1->FormBorderStyle = ::FormBorderStyle::FixedDialog;
      // Set the accept button of the form to button1.
      form1->AcceptButton = button1;
      // Set the cancel button of the form to button2.
      form1->CancelButton = button2;
      // Set the start position of the form to the center of the screen.
      form1->StartPosition = FormStartPosition::CenterScreen;

      // Add button1 to the form.
      form1->Controls->Add( button1 );
      // Add button2 to the form.
      form1->Controls->Add( button2 );
      
      // Display the form as a modal dialog box.
      form1->ShowDialog();
   }

public void CreateMyForm()
 {
    // Create a new instance of the form.
    Form form1 = new Form();
    // Create two buttons to use as the accept and cancel buttons.
    Button button1 = new Button ();
    Button button2 = new Button ();
   
    // Set the text of button1 to "OK".
    button1.Text = "OK";
    // Set the position of the button on the form.
    button1.Location = new Point (10, 10);
    // Set the text of button2 to "Cancel".
    button2.Text = "Cancel";
    // Set the position of the button based on the location of button1.
    button2.Location
       = new Point (button1.Left, button1.Height + button1.Top + 10);
    // Set the caption bar text of the form.   
    form1.Text = "My Dialog Box";
    // Display a help button on the form.
    form1.HelpButton = true;
 
    // Define the border style of the form to a dialog box.
    form1.FormBorderStyle = FormBorderStyle.FixedDialog;
    // Set the accept button of the form to button1.
    form1.AcceptButton = button1;
    // Set the cancel button of the form to button2.
    form1.CancelButton = button2;
    // Set the start position of the form to the center of the screen.
    form1.StartPosition = FormStartPosition.CenterScreen;
    
    // Add button1 to the form.
    form1.Controls.Add(button1);
    // Add button2 to the form.
    form1.Controls.Add(button2);
    
    // Display the form as a modal dialog box.
    form1.ShowDialog();
 }

Public Sub CreateMyForm()
    ' Create a new instance of the form.
    Dim form1 As New Form()
    ' Create two buttons to use as the accept and cancel buttons.
    Dim button1 As New Button()
    Dim button2 As New Button()
    
    ' Set the text of button1 to "OK".
    button1.Text = "OK"
    ' Set the position of the button on the form.
    button1.Location = New Point(10, 10)
    ' Set the text of button2 to "Cancel".
    button2.Text = "Cancel"
    ' Set the position of the button based on the location of button1.
    button2.Location = New Point(button1.Left, button1.Height + button1.Top + 10)
    ' Set the caption bar text of the form.   
    form1.Text = "My Dialog Box"
    ' Display a help button on the form.
    form1.HelpButton = True
    
    ' Define the border style of the form to a dialog box.
    form1.FormBorderStyle = FormBorderStyle.FixedDialog
    ' Set the accept button of the form to button1.
    form1.AcceptButton = button1
    ' Set the cancel button of the form to button2.
    form1.CancelButton = button2
    ' Set the start position of the form to the center of the screen.
    form1.StartPosition = FormStartPosition.CenterScreen
    
    ' Add button1 to the form.
    form1.Controls.Add(button1)
    ' Add button2 to the form.
    form1.Controls.Add(button2)
    
    ' Display the form as a modal dialog box.
    form1.ShowDialog()
End Sub

설명

이 속성을 사용하면 런타임에 폼이 표시될 때 폼의 시작 위치를 설정할 수 있습니다. 폼의 위치는 속성을 설정 Location 하거나 Windows에서 지정한 기본 위치를 사용하여 수동으로 지정할 수 있습니다. MDI(다중 문서 인터페이스) 자식 양식과 같은 양식의 경우 화면 가운데 또는 부모 양식의 가운데에 표시할 폼을 배치할 수도 있습니다.

양식이 표시되기 전에 이 속성을 설정해야 합니다. 또는 메서드를 호출 Show 하기 전에 또는 ShowDialog 양식의 생성자에서 이 속성을 설정할 수 있습니다.

추가 정보

• FormStartPosition