CListBox::SetTabStops

Článek
06/10/2015

Nastaví zarážku tabulátoru pozice v seznamu.

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

Parametry

cxEachStop
Zarážky tabulátoru jsou nastaveny na každé cxEachStop jednotek v dialogovém okně.Viz rgTabStops popis jednotky dialogové okno.
nTabStops
Určuje počet zarážek tabulátoru v seznamu.
rgTabStops
Body prvního člena pole pozice zarážky v dialogovém okně jednotky obsahující celá čísla.Dialogové okno jednotka je vodorovná nebo svislá vzdálenost.Jednu čtvrtinu aktuální jednotku základní šířky dialogové okno rovna jedné vodorovné okno jednotky a osmina aktuální výšky základní jednotky dialogové okno rovna jedné jednotky pro svislé dialogové okno.Dialogové okno základní jednotky jsou výpočet založen na výšku a šířku aktuální písmo systému.GetDialogBaseUnits Windows funkce vrací aktuální okno základních jednotek v pixelech.Zarážky tabulátoru, musí být seřazeny vzestupně; tabulátory nejsou povoleny.

Vrácená hodnota

Nenulová hodnota, pokud byly nastaveny na karty; jinak 0.

Poznámky

Výchozí velikost 2 jednotky v dialogovém okně nastavit zarážky tabulátoru, volání bez parametrů verzi této členské funkce.Nastavit zarážky tabulátoru na velikost než 2, volání verze se cxEachStop argument.

Nastavit zarážky tabulátoru na matici velikosti pomocí verze s rgTabStops a nTabStops argumenty.Nastaví zarážku tabulátoru pro každou hodnotu v rgTabStops , číslo určené nTabStops .

Reagovat na volání SetTabStops členské funkce seznamu musí být vytvořen s LBS_USETABSTOPS styl.

Příklad

// 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()));