Sdílet prostřednictvím

ScrollableControl.AutoScrollMargin Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví velikost okraje automatického posouvání.

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

Hodnota vlastnosti

Size

A Size , který představuje výšku a šířku okraje automatického posouvání v pixelech.

Výjimky

ArgumentOutOfRangeException

Přiřazená Height hodnota Width je menší než 0.

Příklady

Následující příklad kódu používá odvozenou třídu, Panel. Příklad vyhodnotí umístění textového pole a změní vzhled a chování nadřazeného kontejneru, ovládací prvek panelu. Příklad vyžaduje, abyste vytvořili instanci Panel ovládacího prvku TextBoxa Button. Umístěte textové pole na panel tak, aby se překrýval aspoň jeden z okrajů panelu. Tuto funkci zavolejte kliknutím na tlačítko, abyste viděli rozdíl v chování a vzhledu panelu.

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

Poznámky

Okraj automatického posouvání je vzdálenost mezi všemi podřízenými ovládacími prvky a hrany posouvání nadřazeného ovládacího prvku. Velikost AutoScrollMargin se přidá k velikosti všech podřízených ovládacích prvků obsažených v ovládacím prvku pro posouvání, abyste zjistili, jestli jsou potřeba posuvníky. Vlastnost AutoScrollMargin se vyhodnotí, když se změní velikost nadřazeného posuvníkového ovládacího prvku nebo se přenesou jednotlivé podřízené ovládací prvky do zobrazení a slouží k určení, jestli se musí zobrazit posuvníky. Ukotvené ovládací prvky jsou vyloučeny z výpočtů, které určují, jestli se musí zobrazit posuvníky.

Poznámka

Pokud je vlastnost ukotveného ovládacího prvku Dock nastavena na DockStyle.Fill, ovládací prvek vyplní nadřazený posouvání ovládací prvek a ukotvený ovládací prvek se ignoruje při použití k AutoScrollMargin určení, jestli jsou potřeba posuvníky.

Pokud je vzdálenost od okraje podřízeného ovládacího prvku k nadřazeného posuvníku menší než hodnota přiřazená AutoScrollMargin vlastnosti a AutoScroll vlastnost je nastavena na true, zobrazí se příslušný posuvník.

Poznámka

Při ukotvení ovládacích prvků v ovládacím prvku s možností posouvání doporučujeme přidat podřízený posuvný ovládací prvek, například Panelovládací prvek, který bude obsahovat všechny další ovládací prvky, které můžou vyžadovat posouvání. Podřízený ovládací prvek byste měli přidat Panel do posuvného ovládacího prvku a jeho Dock vlastnosti nastavené na DockStyle.Fill a jeho AutoScroll vlastnost nastavena na true. Vlastnost nadřazeného ovládacího prvku pro posouvání byste měli nastavit AutoScroll na falsehodnotu .

Platí pro

Viz také