Partilhar via


CEdit::SetTabStops

Chamar essa função para definir as paradas de tabulação em um controle de edição de várias linhas.

void SetTabStops( ); 
BOOL SetTabStops( 
   const int& cxEachStop  
); 
BOOL SetTabStops( 
   int nTabStops, 
   LPINT rgTabStops  
);

Parâmetros

  • cxEachStop
    Especifica que as paradas de tabulação devem ser definidas em unidades de cada caixa de diálogo de cxEachStop .

  • nTabStops
    Especifica o número de tabulações contidas em rgTabStops. Esse número deve ser maior que 1.

  • rgTabStops
    Aponta para uma matriz de números inteiros sem sinal que especificam as paradas de tabulação em unidades de diálogo. Uma unidade de diálogo é a distância horizontal ou vertical. Uma unidade horizontal da caixa de diálogo é igual a um quarto da unidade atual da largura de base da caixa de diálogo, e 1 unidade vertical da caixa de diálogo é igual ao de um oitava da unidade atual de altura de base da caixa de diálogo. As unidades base da caixa de diálogo são computadas com base na altura e a largura da fonte do sistema atual. A função do windows de GetDialogBaseUnits retorna as unidades base da caixa de diálogo atual em pixels.

Valor de retorno

Diferente de zero se as guias foram alterados; se não 0.

Comentários

Quando o texto é copiado para um controle de edição de várias linhas, qualquer caractere de tabulação em texto fará com que o espaço a ser gerado até a parada de tabulação seguir.

Para definir paradas de tabulação para o tamanho padrão de 32 unidades de diálogo, chame a versão sem parâmetros da função de membro. Para definir paradas de tabulação para um tamanho diferente de 32, chame a versão com o parâmetro de cxEachStop . Para definir paradas de tabulação em uma matriz de tamanho, use a versão com dois parâmetros.

Essa função de membro é processada por controles de edição de várias linhas.

SetTabStops automaticamente não redesenho a janela de edição. Se você alterar as paradas de tabulação para o texto já no controle de edição chamada, CWnd::InvalidateRect para redesenhar a janela de edição.

Para obter mais informações, consulte EM_SETTABSTOPS e GetDialogBaseUnits em Windows SDK.

Exemplo

Consulte o exemplo para CEditView::SetTabStops.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CEdit

Gráfico da hierarquia

CWnd::InvalidateRect