Método IBufferGraph.MapDownToFirstMatch (SnapshotPoint, PointTrackingMode, Predicate<ITextSnapshot>, PositionAffinity)

Artigo
05/17/2015

Mapeia uma posição no gráfico para uma posição em um buffer correspondente menor no gráfico. Buffers de origem são considerados ser menor do que os buffers de projeção que consomem-los.

Namespace: Microsoft.VisualStudio.Text.Projection
Assembly: Microsoft.VisualStudio.Text.Data (em Microsoft.VisualStudio.Text.Data.dll)

Sintaxe

'Declaração
Function MapDownToFirstMatch ( _
    position As SnapshotPoint, _
    trackingMode As PointTrackingMode, _
    match As Predicate(Of ITextSnapshot), _
    affinity As PositionAffinity _
) As Nullable(Of SnapshotPoint)

Nullable<SnapshotPoint> MapDownToFirstMatch(
    SnapshotPoint position,
    PointTrackingMode trackingMode,
    Predicate<ITextSnapshot> match,
    PositionAffinity affinity
)

Nullable<SnapshotPoint> MapDownToFirstMatch(
    SnapshotPoint position, 
    PointTrackingMode trackingMode, 
    Predicate<ITextSnapshot^>^ match, 
    PositionAffinity affinity
)

abstract MapDownToFirstMatch : 
        position:SnapshotPoint * 
        trackingMode:PointTrackingMode * 
        match:Predicate<ITextSnapshot> * 
        affinity:PositionAffinity -> Nullable<SnapshotPoint>

function MapDownToFirstMatch(
    position : SnapshotPoint, 
    trackingMode : PointTrackingMode, 
    match : Predicate<ITextSnapshot>, 
    affinity : PositionAffinity
) : Nullable<SnapshotPoint>

Parâmetros

position
Tipo: Microsoft.VisualStudio.Text.SnapshotPoint

A posição em um buffer no gráfico.

trackingMode
Tipo: Microsoft.VisualStudio.Text.PointTrackingMode

Como position é controlado o atual snapshot se necessário.

match
Tipo: Predicate<ITextSnapshot>

O predicado que identifica o buffer de destino.

affinity
Tipo: Microsoft.VisualStudio.Text.PositionAffinity

Se o mapeamento é ambíguo (a posição está em uma fenda span de origem), a determina se o mapeamento deve visar a posição imediatamente após o caractere anterior ou imediatamente antes do caractere seguinte no buffer superior.

Essa configuração não terá efeito se o mapeamento é ambíguo.

Valor de retorno

Tipo: Nullable<SnapshotPoint>
Um ponto em um instantâneo do buffer de destino, ou nulluma referência nula (Nothing no Visual Basic) se a posição não é mapeado para baixo para qualquer buffer selecionado por match.

Exceções

Exceção	Condição
ArgumentNullException	position.Snapshot or match is nulluma referência nula (Nothing no Visual Basic).
ArgumentOutOfRangeException	trackingModeis not a valid PointTrackingMode, or affinity is not a valid PositionAffinity.

Comentários

O match predicado é chamado em cada buffer de texto no gráfico de buffer até que ele retorne true. Depois que o predicado não é chamado novamente.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IBufferGraph Interface

Sobrecargas MapDownToFirstMatch

Namespace Microsoft.VisualStudio.Text.Projection

Compartilhar via