ScrollableControl.AutoScrollMargin Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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, setPublic Property AutoScrollMargin As SizeHodnota vlastnosti
A Size , který představuje výšku a šířku okraje automatického posouvání v pixelech.
Výjimky
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 .