CListBox::SetTabStops

Artigo
08/25/2010

Define as posições de tabulação em um lista caixa.

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

Parâmetros

cxEachStop
Paradas de tabulação são conjunto em cada cxEachStop unidades de diálogo. See rgTabStops para obter uma descrição de uma unidade da caixa de diálogo.
nTabStops
Especifica o número de paradas de tabulação na lista caixa.
rgTabStops
Aponta para o primeiro membro de uma matriz de inteiros que contém o guia-parar posições nas unidades de diálogo.Uma unidade de caixa de diálogo é a distância horizontal ou vertical.Uma unidade horizontal da caixa de diálogo é igual a um quarto da unidade base largura diálogo corrente e uma unidade vertical da caixa de diálogo é igual a um oitavo da unidade de altura base corrente do diálogo.As unidades base da caixa de diálogo são calculadas com base na altura e largura da fonte de sistema corrente.The GetDialogBaseUnits Função Windows retorna unidades base, a caixa de diálogo corrente em pixels.O guia paradas devem ser classificadas em ordem crescente; traseiro guia s não são permitidos.

Valor de retorno

Diferente de zero se todas as guias foram conjunto; caso contrário, 0.

Comentários

Para conjunto paradas de tabulação para o dimensionar padrão de 2 unidades de diálogo, telefonar versão dessa função de membro sem parâmetros.Para conjunto guia pára em um dimensionar diferente de 2, chame a versão com o cxEachStop argumento.

Para conjunto guia pára a uma matriz de tamanhos, usar a versão com o rgTabStops e nTabStops argumentos. Uma parada de tabulação será definida para cada valor em rgTabStops, o número especificado por nTabStops.

Para responder a uma telefonar para o SetTabStops função de membro, a caixa de listagem deve ter sido criada com o LBS_USETABSTOPS estilo.

Exemplo

// Find the pixel width of the largest first substring.
CString str;
CSize   sz;
int     nIndex, dx = 0;
CDC*    pDC = myListBox.GetDC();
for (int i = 0; i < myListBox.GetCount(); i++)
{
   myListBox.GetText( i, str );

   if ((nIndex = str.Find('\t')) != -1)
      str = str.Right(nIndex);

   sz = pDC->GetTextExtent(str);

   if (sz.cx > dx)
      dx = sz.cx;
}
myListBox.ReleaseDC(pDC);

// Set tab stops at every one and 1/3 units
// of the largest string. 
// NOTE: Convert pixels to dialog units.
myListBox.SetTabStops((dx*4/3 * 4) / LOWORD(::GetDialogBaseUnits()));