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 automatického posuvného okraje.
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. Voláním této funkce kliknutím na tlačítko zobrazíte 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 okraji posuvného 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í, aby bylo možné určit, zda jsou posuvníky potřeba nebo ne. Vlastnost AutoScrollMargin se vyhodnocuje při změně velikosti nadřazeného ovládacího prvku pro posouvání nebo zobrazení jednotlivých podřízených ovládacích prvků a slouží k určení, zda je nutné zobrazit posuvníky. Ukotvené ovládací prvky jsou vyloučené 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ý posuvný ovládací prvek a ukotvený ovládací prvek bude ignorován při použití posuvníku AutoScrollMargin k určení, zda jsou posuvníky potřeba.
Pokud vzdálenost od okraje podřízeného ovládacího prvku k nadřazeného posuvného ovládacího prvku je menší než hodnota přiřazená vlastnosti AutoScrollMargin a AutoScroll vlastnost je nastavena na true, zobrazí se příslušný posuvník.
Poznámka:
Při ukotvování ovládacích prvků v ovládacím prvku umožňujícím posouvání doporučujeme přidat podřízený posuvný ovládací prvek, například Panel, který bude obsahovat všechny další ovládací prvky, které mohou vyžadovat posouvání. Podřízený Panel ovládací prvek byste měli přidat do posuvného ovládacího prvku a jeho Dock vlastnost nastavena na DockStyle.Fill a jeho AutoScroll vlastnost nastavena na true. Měli byste nastavit AutoScroll vlastnost nadřazeného posuvného ovládacího prvku na falsehodnotu .
