Partilhar via


Como: fornecer suporte a texto oculto

Você pode criar regiões de texto oculto e regiões de estrutura de tópicos. Regiões de texto oculto podem ser controlado pelo cliente ou controlado pelo editor e são usados para ocultar uma região do texto completamente. O editor exibe uma região oculta como linhas horizontais. Um exemplo disso é o modo de exibição somente Script no editor de HTML.

Procedimento

Para implementar uma região de texto oculto

  1. Call QueryService for SVsTextManager.

    Isso retorna um ponteiro para IVsHiddenTextManager.

  2. Chame GetHiddenTextSession, passing em um ponteiro para um buffer de texto indicado. Isso determina se uma sessão de texto oculto já existe para o buffer.

  3. Se já existir, então você não precisará criar uma e um ponteiro para o existente IVsHiddenTextSession objeto é retornado. Use esse ponteiro para enumerar e criar regiões de texto oculto. Caso contrário, chamar CreateHiddenTextSession para criar uma sessão de texto oculto para o buffer.

    Um ponteiro para o IVsHiddenTextSession objeto é retornado.

    Dica

    Quando você chama CreateHiddenTextSession, você pode especificar um cliente de texto oculto (ou seja, IVsHiddenTextClient).O cliente de texto oculto notifica quando o texto oculto ou estrutura de tópicos está expandida ou recolhida pelo usuário.

  4. Chame AddHiddenRegions para adicionar um ou mais novo contorno regiões ao mesmo tempo, especifique as seguintes informações no reHidReg (NewHiddenRegion) parâmetro:

    1. Especifique um valor de hrtConcealed na iType membro da NewHiddenRegion estrutura para indicar que você está criando uma região oculta, em vez de uma região de estrutura de tópicos.

      Dica

      Quando escondidos regiões estão ocultas, o editor exibe automaticamente linhas ao redor das regiões ocultas para indicar sua presença.

    2. Especifique se a região é controlado pelo cliente ou controlado pelo editor na dwBehavior os membros da NewHiddenRegion estrutura. A implementação de estrutura de tópicos inteligente pode conter uma combinação de estrutura de tópicos do editor e o cliente controlados e regiões de texto oculto.