ScrollableControl.AutoScrollPosition Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

Point

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

Atributy

BrowsableAttribute

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í.

Viz také

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll