CPagerCtrl::Create

更新 : 2007 年 11 月

指定されたスタイルを使用してページャコントロールを作成し、それを現在の CPagerCtrl オブジェクトに関連付けます。

virtual BOOL Create(
                DWORD dwStyle, 
                const RECT& rect, 
                CWnd* pParentWnd, 
                UINT nID
);

パラメータ

パラメータ	説明
[入力] dwStyle	コントロールに適用するウィンドウスタイルとページャコントロールスタイルのビットごとの組み合わせ (OR)。
[入力] rect	クライアント座標で表したコントロールの位置とサイズが含まれている RECT 構造体への参照。
[入力] pParentWnd	コントロールの親ウィンドウである CWnd オブジェクトへのポインタ。このパラメータには、NULL は指定できません。
[入力] nID	コントロールの ID。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

必要条件

ヘッダー : afxcmn.h

解説

ページャコントロールを作成するには、CPagerCtrl 変数を宣言してから、その変数に対して CPagerCtrl::Create メソッドまたは CPagerCtrl::CreateEx メソッドを呼び出します。

使用例

ページャコントロールを作成してから、CPagerCtrl::SetChild メソッドを使用して非常に長いボタンコントロールをそのページャコントロールに関連付ける例を以下に示します。この例ではさらに、CPagerCtrl::SetButtonSize メソッドを使用してページャコントロールの高さを 20 ピクセルに設定し、CPagerCtrl::SetBorder メソッドを使用して境界線の太さを 1 ピクセルに設定します。

    // Initialize the dropdown menu of the splitbutton control.
    m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

    // Create the pager control.
    BOOL nRet;
    CRect rect;
    GetClientRect(&rect);
    nRet = m_pager.Create(
        (WS_VISIBLE | WS_CHILD | PGS_HORZ),
        CRect(rect.Width()/4, 5, (rect.Width() * 3)/4, 55),
        this,
        IDC_PAGER1); 

    m_pager.GetClientRect( &rect );
    nRet = m_button.Create(
        _T("This is a very, very long button. 012345678901234567890"), 
        (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
        CRect(0,0,rect.Width(),30), 
        &m_pager, IDC_BUTTON1);

    m_pager.SetChild(m_button.m_hWnd);
    m_pager.SetButtonSize( 20 );
    m_pager.SetBorder( 1 );