ScrollableControl.AutoScrollMargin 属性

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

获取或设置自动滚动边距的大小。

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

Size，表示自动滚动边距的高度和宽度（以像素为单位）。

例外

ArgumentOutOfRangeException

分配的 Height 或 Width 值小于 0。

示例

下面的代码示例使用派生类。 Panel 该示例评估文本框的位置，并更改其父容器（面板控件）的外观和行为。 该示例要求你已创建控件的 Panel 实例， TextBox以及 Button。 将文本框放在面板上，使其与面板的边缘至少重叠。 单击按钮可调用此函数，以查看面板的行为和外观的差异。

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

注解

自动滚动边距是任何子控件与可滚动父控件边缘之间的距离。 大小 AutoScrollMargin 将添加到可滚动控件中包含的任何子控件的大小，以确定是否需要滚动条。 AutoScrollMargin当调整父可滚动控件的大小或将单个子控件引入视图中时，将评估该属性，并用于确定是否必须显示滚动条。 停靠控件从计算中排除，以确定是否必须显示滚动条。

备注

如果将停靠控件 Dock 的属性设置为 DockStyle.Fill，则控件将填充父可滚动控件，在使用确定是否需要滚动条时 AutoScrollMargin 忽略停靠控件。

如果子控件边缘到父可滚动控件的距离小于分配给 AutoScrollMargin 属性的值，并且 AutoScroll 该属性设置为 true该值，则会显示相应的滚动条。

备注

我们建议在可滚动控件内停靠控件时，添加子可滚动控件（例如 a Panel）以包含可能需要滚动的任何其他控件。 应将子Panel控件添加到可滚动控件及其属性集，DockStyle.Fill AutoScroll true并将其Dock属性设置为 。 应将 AutoScroll 父可滚动控件的属性设置为 false。

适用于

另请参阅