CListBox::SetHorizontalExtent

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

リストボックスを水平方向にスクロールできる最大幅をピクセル数で設定します。

void SetHorizontalExtent(
   int cxExtent 
);

パラメータ

cxExtent
リストボックスの水平スクロール幅をピクセル数で指定します。

解説

リストボックスのサイズがこの値よりも小さいと、水平スクロールバーを使って、リストボックスの項目を水平にスクロールできます。リストボックスのサイズがこの値以上であると、水平スクロールバーは表示されません。

SetHorizontalExtent 関数に応答できるのは、WS_HSCROLL スタイルで定義されているリストボックスだけです。

このメンバ関数は、複数桁のリストボックスでは利用できません。複数桁のリストボックスでは SetColumnWidth メンバ関数を使います。

使用例

// Find the longest string in the list box.
CString    str;
CSize      sz;
int        dx = 0;
TEXTMETRIC tm;
CDC*       pDC = m_myListBox.GetDC();
CFont*     pFont = m_myListBox.GetFont();

// Select the listbox font, save the old font
CFont* pOldFont = pDC->SelectObject(pFont);
// Get the text metrics for avg char width
pDC->GetTextMetrics(&tm); 

for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   // Add the avg width to prevent clipping
   sz.cx += tm.tmAveCharWidth;

   if (sz.cx > dx)
      dx = sz.cx;
}
// Select the old font back into the DC
pDC->SelectObject(pOldFont);
m_myListBox.ReleaseDC(pDC);

// Set the horizontal extent so every character of all strings 
// can be scrolled to.
m_myListBox.SetHorizontalExtent(dx);