Číst v angličtině

Sdílet prostřednictvím


ScrollableControl.AutoScrollPosition Vlastnost

Definice

Získá nebo nastaví umístění pozice automatického posouvání.

[System.ComponentModel.Browsable(false)]
public System.Drawing.Point AutoScrollPosition { get; set; }

Hodnota vlastnosti

A Point , který představuje pozici automatického posouvání v pixelech.

Atributy

Příklady

Následující příklad kódu používá odvozenou ScrollableControl třídu Panel a přidá tlačítko do levého horního rohu posuvné oblasti. Příklad umožňuje posun určený hodnotou AutoScrollPosition. Příklad byl napsán za předpokladu, že máte objekt Form , který obsahuje Panel objekt s objektem .Button Pokud chcete povolit automatické posouvání, umístěte tlačítko mimo oblast klienta nástroje Panel.

private void button1_Click(object sender, EventArgs e)
{
   /* Add a button to top left corner of the 
    * scrollable area, allowing for the offset. */
   panel1.AutoScroll = true;
   Button myButton = new Button();
   myButton.Location = new Point(
      0 + panel1.AutoScrollPosition.X, 
      0 + panel1.AutoScrollPosition.Y);
   panel1.Controls.Add(myButton);
}

Poznámky

Vlastnost AutoScrollPosition představuje umístění viditelné části posouvatelného ovládacího prvku. Pomocí této vlastnosti můžete změnit část zobrazeného ovládacího prvku.

Při programovém přidávání ovládacích prvků do formuláře použijte AutoScrollPosition vlastnost k umístění ovládacího prvku uvnitř nebo vně aktuální zobrazitelné oblasti posouvání.

Poznámka

Načtené X hodnoty souřadnic a Y jsou záporné, pokud se ovládací prvek posune mimo počáteční pozici (0,0). Když nastavíte tuto vlastnost, musíte vždy přiřadit kladné X hodnoty a Y pro nastavení pozice posouvání vzhledem k počáteční pozici. Pokud máte například vodorovný posuvník a nastavíte x a y na 200, posunete posun o 200 pixelů doprava; Pokud pak nastavíte x a y na 100, posouvání vypadá, že přeskočí doleva o 100 pixelů, protože ho nastavujete 100 pixelů od počáteční pozice. V prvním případě AutoScrollPosition vrátí {-200, 0}; v druhém případě vrátí {-100,0}hodnotu .

Pokud chcete zjistit, kdy AutoScrollPosition se změny změní, vytvořte obslužnou rutinu Paint události pro událost, uložte starou hodnotu pozice do privátní proměnné a porovnejte novou hodnotu se starou hodnotou u následných Paint událostí.

Platí pro

Produkt Verze
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Viz také