CHeaderCtrl::Create
ヘッダー コントロールを作成し、CHeaderCtrl のオブジェクトにアタッチします。
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
パラメーター
dwStyle
ヘッダー コントロールのスタイルを指定します。ヘッダー コントロールのスタイルの詳細については、Windows SDKの ヘッダー コントロールのスタイル を参照してください。rect
ヘッダー コントロールのサイズと位置を指定します。これは CRect のオブジェクトまたは RECT の構造体のいずれかです。pParentWnd
ヘッダー コントロールの親ウィンドウ、通常 CDialogを指定します。これは nullである必要があります。nID
ヘッダー コントロールの ID を指定します。
戻り値
初期化が成功した場合は、; それ以外の場合は。
解説
CHeaderCtrl オブジェクトは、次の手順で構築します。最初に、ヘッダー コントロールを作成し、CHeaderCtrl のオブジェクトに関連するコンストラクターを呼び出し、次に **[作成]**を呼び出します。
ヘッダー コントロールのスタイルだけでなく、ヘッダー コントロールの位置がのサイズを変更するかを判断するには、以下のコモン コントロールのスタイルを使用し、(詳細については コモン コントロールのスタイル を参照) :
CCS_BOTTOM により、コントロールは、親ウィンドウのクライアント領域の下で、自身を設定します。親ウィンドウの幅と同じになる幅を設定します。
CCS_NODIVIDER は 2 ピクセルの強調表示がコントロールの上に描画されることを防ぎます。
CCS_NOMOVEY により、コントロールは WM_SIZE のメッセージに応答して自身を、水平方向、垂直方向にサイズを変更し、実行します。CCS_NORESIZE のスタイルが使用されている場合、このスタイルは適用されません。ヘッダー コントロールに、このスタイルが既定で含まれます。
CCS_NOPARENTALIGN は、コントロールが親ウィンドウの上部または下部に自動的に実行されなくなります。代わりに、コントロールは、親ウィンドウのサイズの変更に関係なく親ウィンドウ内の位置を維持します。CCS_TOP または CCS_BOTTOM のスタイルも使用されている場合、高さは既定値に調整されますが、位置、および幅は変化しません。
CCS_NORESIZE は、最初のサイズまたは新しいサイズを設定すると、コントロールが既定の幅と高さを使用することを防止できます。代わりに、コントロールが作成またはサイズ変更に対する要求で指定した幅と高さを使用します。
CCS_TOP により、コントロールは、親ウィンドウのクライアント領域の上部に、自身を設定します。親ウィンドウの幅と同じになる幅を設定します。
また、ヘッダー コントロールに次のウィンドウ スタイルを適用できます (詳細については [ウィンドウ スタイル] を参照) :
WS_CHILD または子ウィンドウを作成します。WS_POPUP のスタイルでは使用できません。
WS_VISIBLE は最初に表示するウィンドウを作成します。
WS_DISABLED は、最初に無効にするウィンドウを作成します。
WS_GROUP は、ユーザーが 1 のコントロールからキーと方向の次の位置にできるコントロールのグループの最初のコントロールを指定します。最初のコントロールの後に WS_GROUP のスタイルに定義されているすべてのコントロールは、同じグループに属しています。WS_GROUP のスタイルの次のコントロールは、次の場所にあるか) スタイルのグループを終了し、次のグループを呼び出します (つまり、1 種類のグループが終了します。
WS_TABSTOP では、Tab キーを使用して実行できるいくつでもコントロールの 1 種類を指定します。Tab キーは WS_TABSTOP のスタイルで指定された次のコントロールにユーザーを移動します。
は、コントロールとの拡張ウィンドウ スタイルを使用する場合は、**[作成]**の代わりに CreateEx を呼び出します。
使用例
// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
CRect(10, 10, 600, 50), pParentWnd, 1);
必要条件
ヘッダー: afxcmn.h