ScrollableControl.AutoScrollPosition 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í umístění pozice automatického posouvání.
public:
property System::Drawing::Point AutoScrollPosition { System::Drawing::Point get(); void set(System::Drawing::Point value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Point AutoScrollPosition { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.AutoScrollPosition : System.Drawing.Point with get, set
Public Property AutoScrollPosition As Point
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 = gcnew Button;
myButton->Location = Point(0 + panel1->AutoScrollPosition.X,0 + panel1->AutoScrollPosition.Y);
panel1->Controls->Add( myButton );
}
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);
}
Private Sub button1_Click(sender As Object, _
e As EventArgs) Handles button1.Click
' Add a button to top left corner of the
' scrollable area, allowing for the offset.
panel1.AutoScroll = True
Dim myButton As New Button()
myButton.Location = New Point( _
0 + panel1.AutoScrollPosition.X, _
0 + panel1.AutoScrollPosition.Y)
panel1.Controls.Add(myButton)
End Sub
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í.