ScrollViewer.CanContentScroll Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob Elemente, die die IScrollInfo-Schnittstelle unterstützen, bildlauffähig sind, oder legt diesen fest.Gets or sets a value that indicates whether elements that support the IScrollInfo interface are allowed to scroll.

public:
 property bool CanContentScroll { bool get(); void set(bool value); };
public bool CanContentScroll { get; set; }
member this.CanContentScroll : bool with get, set
Public Property CanContentScroll As Boolean

Eigenschaftswert

true, wenn der ScrollViewer einen Bildlauf hinsichtlich logischer Einheiten ausführt; false, wenn der ScrollViewer einen Bildlauf hinsichtlich physikalischer Einheiten ausführt.true if the ScrollViewer scrolls in terms of logical units; false if the ScrollViewer scrolls in terms of physical units. Der Standardwert ist false.The default is false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die CanContentScroll-Eigenschaft mithilfe von Code festgelegt wird.The following example demonstrates how to set the CanContentScroll property by using code.

private void scrollTrue(object sender, RoutedEventArgs e)
{
    svrContent.CanContentScroll = true;
    svrContent.Height = 600;
    myStackPanel.Visibility = Visibility.Visible;
    btnEnableContentScrolling.Visibility = Visibility.Collapsed;
}
Private Sub scrollTrue(ByVal sender As Object, ByVal args As RoutedEventArgs)
    sv1.CanContentScroll = True
    sv1.Height = 600
    myStackPanel.Visibility = Visibility.Visible
    btn1.Visibility = Visibility.Collapsed
End Sub

Hinweise

Der Inhalt einer ScrollViewer kann in Form physischer Einheiten oder logischer Einheiten gescrollt werden.Content in a ScrollViewer can be scrolled in terms of physical units or logical units. Physische Einheiten sind geräteunabhängige Pixel.Physical units are device independent pixels. Logische Einheiten werden für das Scrollen von Elementen innerhalb einer ItemsControlverwendet.Logical units are used for scrolling items within an ItemsControl. Das Standardverhalten des ScrollViewer ist die Verwendung physischer Einheiten, um einen Bildlauf für den Inhalt durchführen zu können.The default behavior of the ScrollViewer is to use physical units to scroll its content. In Fällen, in denen die CanContentScroll auf truefestgelegt ist, kann der Inhalt jedoch logische Einheiten zum Scrollen verwenden.However, in cases where the CanContentScroll is set to true, the content could use logical units to scroll. Beispielsweise können ListBox, ListViewund andere Steuerelemente, die von Erben ItemsControl logische Einheiten zum Scrollen verwenden.For example, ListBox, ListView, and other controls that inherit from ItemsControl use logical units to scroll. Wenn CanContentScroll trueist, sind die Werte der Eigenschaften ExtentHeight, ScrollableHeight, ViewportHeightund VerticalOffset die Anzahl der Elemente anstelle physischer Einheiten.If CanContentScroll is true, the values of the ExtentHeight, ScrollableHeight, ViewportHeight, and VerticalOffset properties are number of items, instead of physical units.

Wenn Sie einen physischen Bildlauf anstelle eines logischen Bildlaufs benötigen, wrappen Sie den Host Panel Element in einem ScrollViewer, und legen Sie dessen Eigenschaft CanContentScroll auf falsefest.If you require physical scrolling instead of logical scrolling, wrap the host Panel element in a ScrollViewer and set its CanContentScroll property to false. Physischer Bildlauf ist das Standardbild Laufverhalten für die meisten Panel Elemente.Physical scrolling is the default scroll behavior for most Panel elements.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field CanContentScrollProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für: