CPagerCtrl::Create

2011-08-09

指定されたスタイルを使用してページャーコントロールを作成し、それを現在の 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 );