StackPanel.GetInsertionIndexes(Point, Int32, Int32) Método

Definição

Namespace:

Windows.UI.Xaml.Controls

Retorna os valores de índice dos itens entre os quais o ponto especificado está.

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)

Parâmetros

position

Point

O ponto para o qual obter índices de inserção.

first

Int32

int

O índice do item antes do ponto especificado.

second

Int32

int

O índice do item após o ponto especificado.

Implementações

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@)

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

Chame esse método ao manipular um evento DragOver para retornar os índices dos dois itens entre os quais o DragOver está acontecendo e onde uma possível queda e inserção ocorreria.

Compatibilidade de versões

O método GetInsertionIndexes não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não chame esse método sem primeiro executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença desse método antes de usá-lo.

<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);
        }
    }
}