ScrollableControl.AutoScrollMargin 속성

정의

자동 스크롤 여백의 크기를 가져오거나 설정합니다.Gets or sets the size of the auto-scroll margin.

public:
 property System::Drawing::Size AutoScrollMargin { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size AutoScrollMargin { get; set; }
member this.AutoScrollMargin : System.Drawing.Size with get, set
Public Property AutoScrollMargin As Size

속성 값

자동 스크롤 여백의 높이와 너비를 픽셀 단위로 나타내는 Size입니다.A Size that represents the height and width of the auto-scroll margin in pixels.

예외

할당된 Height 또는 Width 값이 0보다 작은 경우The Height or Width value assigned is less than 0.

예제

다음 코드 예제에서는 파생된 클래스인 Panel합니다.The following code example uses the derived class, Panel. 입력란의 위치를 평가 하 고 해당 부모 컨테이너에서 패널 컨트롤의 동작과 모양을 변경 하는 예제.The example evaluates the location of a text box and changes the appearance and behavior of its parent container, the panel control. 이 예제를 사용 하려면 Panel 컨트롤, TextBoxButton의 인스턴스를 만들어야 합니다.The example requires that you have created an instance of a Panel control, TextBox, and Button. 패널의 가장자리 중 하나 이상 겹치도록 패널에 입력란을 배치 합니다.Place the text box on the panel so that it overlaps at least one of the panel's edges. 패널의 동작 및 모양에 차이 보려면 단추를 클릭할 때이 함수를 호출 합니다.Call this function on the click of a button to see the difference in the panel's behavior and appearance.

void SetAutoScrollMargins()
{
   /* If the text box is outside the panel's bounds, 
          turn on auto-scrolling and set the margin. */
   if ( text1->Location.X > panel1->Location.X || text1->Location.Y > panel1->Location.Y )
   {
      panel1->AutoScroll = true;

      /* If the AutoScrollMargin is set to less 
                than (5,5), set it to 5,5. */
      if ( panel1->AutoScrollMargin.Width < 5 || panel1->AutoScrollMargin.Height < 5 )
      {
         panel1->SetAutoScrollMargin( 5, 5 );
      }
   }
}
private void SetAutoScrollMargins()
 {
    /* If the text box is outside the panel's bounds, 
       turn on auto-scrolling and set the margin. */  
    if (text1.Location.X > panel1.Location.X || 
       text1.Location.Y > panel1.Location.Y)
    {
       panel1.AutoScroll = true;
       /* If the AutoScrollMargin is set to less 
          than (5,5), set it to 5,5. */
       if( panel1.AutoScrollMargin.Width < 5 || 
          panel1.AutoScrollMargin.Height < 5)
       {
          panel1.SetAutoScrollMargin(5, 5);
       }
    }
 }
 
Private Sub SetAutoScrollMargins()
    ' If the text box is outside the panel's bounds,
    ' turn on auto-scrolling and set the margin. 
    If (text1.Location.X > panel1.Location.X) Or _
        (text1.Location.Y > panel1.Location.Y) Then
        panel1.AutoScroll = True
        ' If the AutoScrollMargin is set to less
        ' than (5,5), set it to 5,5. 
        If (panel1.AutoScrollMargin.Width < 5) Or _
            (panel1.AutoScrollMargin.Height < 5) Then
            
            panel1.SetAutoScrollMargin(5, 5)
        End If
    End If
End Sub

설명

자동 스크롤 여백의 모든 자식 컨트롤과 스크롤할 수 있는 부모 컨트롤의 가장자리 사이의 거리입니다.The auto-scroll margin is the distance between any child controls and the edges of the scrollable parent control. 스크롤 막대가 필요한 지 여부를 확인 하기 위해 스크롤할 수 있는 컨트롤에 포함 된 자식 컨트롤의 크기에 AutoScrollMargin 크기가 추가 됩니다.The AutoScrollMargin size is added to the size of any child controls contained in the scrollable control to determine whether or not scroll bars are needed. AutoScrollMargin 속성은 스크롤할 수 있는 부모 컨트롤의 크기가 조정 되거나 개별 자식 컨트롤이 표시 될 때 평가 되며 스크롤 막대가 표시 되어야 하는지 여부를 결정 하는 데 사용 됩니다.The AutoScrollMargin property is evaluated when the parent scrollable control is resized or the individual child controls are brought into view, and is used to determine if scroll bars must be displayed. 도킹 된 컨트롤은 스크롤 막대를 표시 해야 하는 경우를 결정 하는 계산에서 제외 됩니다.Docked controls are excluded from the calculations that determine if scroll bars must be displayed.

참고

도킹 된 컨트롤의 Dock 속성이 DockStyle.Fill로 설정 된 경우 컨트롤은 스크롤할 수 있는 부모 컨트롤을 채우고 도킹 된 컨트롤은 AutoScrollMargin을 사용 하 여 스크롤 막대가 필요한 지 여부를 결정할 때 무시 됩니다.If a docked control's Dock property is set to DockStyle.Fill, the control fills the parent scrollable control and the docked control is ignored when using the AutoScrollMargin to determine whether scroll bars are needed.

자식 컨트롤의 가장자리에서 스크롤할 수 있는 부모 컨트롤 까지의 거리가 AutoScrollMargin 속성에 할당 된 값 보다 작고 AutoScroll 속성이 true로 설정 된 경우 적절 한 스크롤 막대가 표시 됩니다.If the distance from the edge of a child control to the parent scrollable control is less than the value assigned to the AutoScrollMargin property and the AutoScroll property is set to true, the appropriate scroll bar is displayed.

참고

스크롤 가능한 컨트롤 내에 컨트롤을 도킹 하는 경우 스크롤이 필요할 수 있는 다른 컨트롤을 포함 하는 스크롤 가능한 자식 컨트롤 (예: Panel)을 추가 하는 것이 좋습니다.We recommend, when docking controls within a scrollable control, that you add a child scrollable control, such as a Panel, to contain any other controls that might require scrolling. 자식 Panel 컨트롤을 스크롤 가능 컨트롤에 추가 하 고 해당 Dock 속성을 DockStyle.Fill로 설정 하 고 해당 AutoScroll 속성을 true으로 설정 해야 합니다.You should add the child Panel control to the scrollable control and its Dock property set to DockStyle.Fill and its AutoScroll property set to true. 스크롤할 수 있는 부모 컨트롤의 AutoScroll 속성을 false으로 설정 해야 합니다.You should set the AutoScroll property of the parent scrollable control to false.

적용 대상

추가 정보