StackPanel.GetInsertionIndexes(Point, Int32, Int32) Methode

Definition

Namespace:

Windows.UI.Xaml.Controls

Gibt die Indexwerte der Elemente zurück, zwischen denen sich der angegebene Punkt befindet.

public:
 virtual void GetInsertionIndexes(Point position, [Out] int & first, [Out] int & second) = GetInsertionIndexes;

void GetInsertionIndexes(Point const& position, [Out] int & first, [Out] int & second);

public void GetInsertionIndexes(Point position, out int first, out int second);

Public Sub GetInsertionIndexes (position As Point, ByRef first As Integer, ByRef second As Integer)

Parameter

position

Point

Der Punkt, für den Einfügeindizes abgerufen werden sollen.

first

Int32

int

Der Index des Elements vor dem angegebenen Punkt.

second

Int32

int

Der Index des Elements nach dem angegebenen Punkt.

Implementiert

M:Windows.UI.Xaml.Controls.IInsertionPanel.GetInsertionIndexes(Windows.Foundation.Point,System.Int32@,System.Int32@) M:Windows.UI.Xaml.Controls.IInsertionPanel.GetInsertionIndexes(Windows.Foundation.Point,int@,int@)

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Rufen Sie diese Methode auf, wenn Sie ein DragOver-Ereignis behandeln, um die Indizes der beiden Elemente zurückzugeben, zwischen denen das DragOver stattfindet, und wo ein potenzielles Ablegen und Einfügen erfolgen würde.

Versionskompatibilität

Die GetInsertionIndexes-Methode ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, rufen Sie diese Methode nicht auf, ohne zuerst eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Methode vorhanden ist, bevor Sie sie verwenden.

<StackPanel AllowDrop="True" DragOver="StackPanel_DragOver">

private void StackPanel_DragOver(object sender, DragEventArgs e)
{
    if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.StackPanel", "GetInsertionIndexes"))
    {
        StackPanel stackPanel = sender as StackPanel;
        if (stackPanel != null)
        {
            int preceedingIndex;
            int subsequentIndex;
            stackPanel.GetInsertionIndexes(e.GetPosition(stackPanel), out preceedingIndex, out subsequentIndex);
        }
    }
}