IMultiSelectionBroker Interface

Definição

Gerencia todo o cursor e selecionando o comportamento de um ITextView . Lida com várias seleções e seleção de caixa. Em todo esse namespace, são considerados parte das seleções e são representados por InsertionPoint .

public interface class IMultiSelectionBroker
public interface IMultiSelectionBroker
type IMultiSelectionBroker = interface
Public Interface IMultiSelectionBroker

Propriedades

ActivationTracksFocus

Determina se AreSelectionsActive o deve controlar quando o ITextView ganha e perde o foco agregado. O padrão é true.

AllSelections

Obtém uma lista de todas as seleções associadas a TextView . Eles serão classificados na ordem de aparência no instantâneo subjacente. Essa propriedade destina-se a operações de edição e pode ser computacionalmente dispendiosa. Se nem todas as seleções forem necessárias, use GetSelectionsIntersectingSpan(SnapshotSpan) em vez disso.

Isso retorna uma seleção como um Selection .

AreSelectionsActive

Se as seleções estão ou não ativas no TextView .

BoxSelection

Se IsBoxSelection for true, retorna uma instanciada Selection que o chamador pode interrogar ou manipular para trabalhar com a própria caixa. Chamadas para AllSelections ou GetSelectionsIntersectingSpan(SnapshotSpan) retornarão as entradas individuais por linha em vez da caixa completa.

Se IsBoxSelection for false, isso retornará NULL.

CurrentSnapshot

Obtém o atual ITextSnapshot que está associado aos pontos de ancoragem, ativos e de inserção para tudo gerenciado por esse agente. Esse instantâneo sempre será baseado no EditBuffer para o associado ITextView .

HasMultipleSelections

Obtém se há várias seleções no AllSelections .

IsBoxSelection

Retorna true se SetBoxSelection(Selection) tiver sido chamado e as seleções estiverem sendo gerenciadas pela geometria de caixa, em vez de manualmente pelo usuário. ClearSecondarySelections() e BreakBoxSelection() ambos reverterão isso para falsee vários outros métodos como, por sua AddSelection(Selection) só, também definirão isso de volta como false.

PrimarySelection

Obtém a seleção primária que deve permanecer após a invocação ClearSecondarySelections() .

SelectedSpans

Obtém a lista de extensões dentro CurrentSnapshot que estão selecionadas. Embora duas seleções não possam se sobrepor, elas podem estar espaço virtual e as seleções podem ser adjacentes. Isso mesclará esses estendes e retornará o conjunto mínimo de intervalos que podem ser usados para descrever a seleção. Essa pode ser uma operação dispendiosa e deve ser executada somente quando necessário.

SelectionExtent

Obtém a extensão que contém todas as seleções, concluídas com o espaço virtual.

TextView

Obtém a exibição para a qual esse agente gerencia seleções.

VirtualSelectedSpans

Fornece o conjunto de intervalos selecionado. Há exatamente uma extensão por seleção, mas ela pode estar vazia. Eles serão classificados na ordem de aparência no documento.

Métodos

AddSelection(Selection)

Adiciona uma seleção a AllSelections .

AddSelectionRange(IEnumerable<Selection>)

Adiciona uma lista de seleções para AllSelections .

BeginBatchOperation()
BreakBoxSelection()

Limpa BoxSelection , mas retém o estado atual das seleções. Esse é um utilitário útil ao executar gestos como end e Home, em que cada seleção se move, mas o resultado não é necessariamente uma caixa.

ClearSecondarySelections()

Remove tudo, exceto o PrimarySelection da sessão.

GetSelectionsIntersectingSpan(SnapshotSpan)

Obtém uma lista de todas as seleções que interseccionam a determinada extensão. O espaço em branco virtual é ignorado para este método.

GetSelectionsIntersectingSpans(NormalizedSnapshotSpanCollection)

Obtém uma lista de todas as seleções que interseccionam a coleção span especificada. O espaço em branco virtual é ignorado para este método.

PerformActionOnAllSelections(Action<ISelectionTransformer>)

Executa uma ação personalizada em todos os Selection s contidos em TextView .

PerformActionOnAllSelections(PredefinedSelectionTransformations)

Executa uma manipulação predefinida em todos os Selection s contidos em TextView .

SetBoxSelection(Selection)

Adiciona uma caixa de seleções com os pontos determinados como seus cantos.

SetSelection(Selection)

Limpa as seleções atuais e adiciona uma como o novo valor. Isso também se torna o PrimarySelection .

SetSelectionRange(IEnumerable<Selection>, Selection)

Limpa as seleções atuais, adiciona o intervalo fornecido e define a seleção primária.

TransformSelection(Selection, PredefinedSelectionTransformations)

Executa a transformação fornecida na seleção especificada sem atualização AllSelections . O comportamento das coordenadas X e Y preferenciais para seleções que já estão no agente é indefinido.

TryEnsureVisible(Selection, EnsureSpanVisibleOptions)

Tenta tornar a seleção determinada visível na exibição.

TryGetSelectionPresentationProperties(Selection, AbstractSelectionPresentationProperties)

Trys para obter as propriedades da interface do usuário associadas à seleção fornecida.

TryPerformActionOnSelection(Selection, Action<ISelectionTransformer>, Selection)

Tenta executar uma ação personalizada em um único Selection .

TryPerformActionOnSelection(Selection, PredefinedSelectionTransformations, Selection)

Tenta executar uma ação predefinida em um único Selection .

TryRemoveSelection(Selection)

Remove uma seleção da exibição.

TrySetAsPrimarySelection(Selection)

Tenta definir a seleção fornecida como a nova PrimarySelection .

Eventos

MultiSelectionSessionChanged

Ocorre quando as seleções são adicionadas/removidas/atualizadas. Além disso, quando a seleção primária é alterada e quando o modo de seleção de caixa é inserido/encerrado.

Aplica-se a