ScrollableControl.AutoScrollPosition Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает расположение позиции автоматической прокрутки.
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, setPublic Property AutoScrollPosition As PointЗначение свойства
Значение, Point представляющее позицию автокручиваемой прокрутки в пикселях.
- Атрибуты
Примеры
В следующем примере кода используется производный ScrollableControl класс Panel и добавляется кнопка в левый верхний угол прокручиваемой области. В примере можно определить смещение, определенное параметром AutoScrollPosition. Пример был написан в соответствии с предположением, что у вас есть объектForm, содержащий Panel на нем.Button Чтобы включить автоматическую прокрутку, поместите кнопку за пределы клиентской 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
Комментарии
Свойство AutoScrollPosition представляет расположение видимой части прокручиваемого элемента управления. Используйте это свойство для изменения части отображаемого элемента управления.
При программном добавлении элементов управления в форму используйте AutoScrollPosition свойство для размещения элемента управления внутри или за пределами текущей области прокрутки.
Замечание
Полученные значения координат Y являются отрицательными, X если элемент управления прокрутился от начальной позиции (0,0). При установке этого свойства необходимо всегда назначать положительные X значения, Y чтобы задать позицию прокрутки относительно начальной позиции. Например, если у вас есть горизонтальная полоса прокрутки, а x и y — 200, переместите прокрутку 200 пикселей вправо; Если затем задать значение x и y равным 100, прокрутка будет переходить слева на 100 пикселей, так как вы устанавливаете его 100 пикселей от начальной позиции. В первом случае возвращает {-200, 0}; во втором случае AutoScrollPosition возвращается {-100,0}.
Чтобы определить, когда AutoScrollPosition изменения изменяются, создайте обработчик событий для Paint события, сохраните старое значение позиции в частной переменной и сравните новое значение со старым значением при последующих Paint событиях.
