Compartilhar via


EM_SETTABSTOPS mensagem

A mensagem EM_SETTABSTOPS define as paradas de tabulação em um controle de edição de várias linhas. Quando o texto é copiado para o controle, qualquer caractere de tabulação no texto faz com que o espaço seja gerado até a próxima parada de tabulação.

Essa mensagem é processada somente por controles de edição de várias linhas. Você pode enviar essa mensagem para um controle de edição ou um controle de edição avançada.

Parâmetros

wParam

O número de paradas de tabulação contidas na matriz. Se esse parâmetro for zero, o parâmetro lParam será ignorado e as paradas de tabulação padrão serão definidas a cada 32 unidades de modelo de caixa de diálogo. Se esse parâmetro for 1, as paradas de tabulação serão definidas em cada n unidades de modelo de caixa de diálogo, em que n é a distância apontada pelo parâmetro lParam . Se esse parâmetro for maior que 1, lParam será um ponteiro para uma matriz de paradas de tabulação.

lParam

Um ponteiro para uma matriz de inteiros sem sinal especificando as paradas de tabulação, em unidades de modelo de caixa de diálogo. Se o parâmetro wParam for 1, esse parâmetro será um ponteiro para um inteiro sem sinal que contém a distância entre todas as paradas de tabulação, em unidades de modelo de caixa de diálogo.

Valor retornado

Se todas as guias estiverem definidas, o valor retornado será TRUE.

Se todas as guias não estiverem definidas, o valor retornado será FALSE.

Comentários

A mensagem de EM_SETTABSTOPS não redesenhe automaticamente a janela de controle de edição. Se o aplicativo estiver alterando as paradas de tabulação do texto que já estão no controle de edição, ele deverá chamar a função InvalidateRect para redesenhar a janela de controle de edição.

Os valores especificados na matriz estão em unidades de modelo de caixa de diálogo, que são as unidades independentes de dispositivo usadas em modelos de caixa de diálogo. Para converter medidas de unidades de modelo de caixa de diálogo em unidades de tela (pixels), use a função MapDialogRect .

Edição avançada: Com suporte no Microsoft Rich Edit 3.0 e posterior. Um controle de edição avançada pode ter o número máximo de paradas de tabulação especificadas por MAX_TAB_STOPS. Para obter informações sobre a compatibilidade de versões de edição avançada com as várias versões do sistema, consulte Sobre controles de edição avançada.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Outros recursos

Invalidaterect

MapDialogRect