ステータス バーを作成するには、CreateStatusWindow 関数を使用するか、CreateWindowEx 関数を使用して STATUSCLASSNAME ウィンドウ クラスを指定します。
ステータス バーの作成後に、ステータス バーを複数のパーツに分割して各パーツのテキストを設定したり、ステータス バー メッセージを使用してウィンドウの外観を制御したりできます。
Note
共通コントロール DLL が確実に読み込まれるようにするには、最初に InitCommonControls 関数を使用します。
知っておくべきこと
テクノロジ
前提条件
- C/C++
- Windows ユーザー インターフェイス プログラミング
手順
ステータス バーを作成する
次の例では、サイズ変更グリップを持つステータス バーを作成し、親ウィンドウのクライアント領域の幅に基づいてウィンドウを 4 等分に分割する方法を示します。
// Description:
// Creates a status bar and divides it into the specified number of parts.
// Parameters:
// hwndParent - parent window for the status bar.
// idStatus - child window identifier of the status bar.
// hinst - handle to the application instance.
// cParts - number of parts into which to divide the status bar.
// Returns:
// The handle to the status bar.
//
HWND DoCreateStatusBar(HWND hwndParent, int idStatus, HINSTANCE
hinst, int cParts)
{
HWND hwndStatus;
RECT rcClient;
HLOCAL hloc;
PINT paParts;
int i, nWidth;
// Ensure that the common control DLL is loaded.
InitCommonControls();
// Create the status bar.
hwndStatus = CreateWindowEx(
0, // no extended styles
STATUSCLASSNAME, // name of status bar class
(PCTSTR) NULL, // no text when first created
SBARS_SIZEGRIP | // includes a sizing grip
WS_CHILD | WS_VISIBLE, // creates a visible child window
0, 0, 0, 0, // ignores size and position
hwndParent, // handle to parent window
(HMENU) idStatus, // child window identifier
hinst, // handle to application instance
NULL); // no window creation data
// Get the coordinates of the parent window's client area.
GetClientRect(hwndParent, &rcClient);
// Allocate an array for holding the right edge coordinates.
hloc = LocalAlloc(LHND, sizeof(int) * cParts);
paParts = (PINT) LocalLock(hloc);
// Calculate the right edge coordinate for each part, and
// copy the coordinates to the array.
nWidth = rcClient.right / cParts;
int rightEdge = nWidth;
for (i = 0; i < cParts; i++) {
paParts[i] = rightEdge;
rightEdge += nWidth;
}
// Tell the status bar to create the window parts.
SendMessage(hwndStatus, SB_SETPARTS, (WPARAM) cParts, (LPARAM)
paParts);
// Free the array, and return.
LocalUnlock(hloc);
LocalFree(hloc);
return hwndStatus;
}
関連トピック