ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin Property

정의

자동 스크롤 여백의 크기를 가져오거나 설정합니다.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 제어 TextBox, 및 Button합니다.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.FillAutoScroll 속성이 설정 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.

적용 대상

추가 정보