CMonthCalCtrl::SetCalID

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

更新 : 2007 年 11 月

現在の月間予定表コントロールのカレンダー識別子を設定します。

BOOL SetCalID(
          CALID calid
);

パラメータ

パラメータ	説明
[入力] calid	カレンダー識別子のいずれかの定数。

戻り値

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

解説

カレンダー識別子は、グレゴリオ暦 (ローカライズ版)、和暦、ヒジュラ暦など、地域ごとに使用されている暦 (カレンダー) を示す識別子です。予定表を含むロケールがコンピュータにインストールされている場合に、SetCalID メソッドを使用して、calid パラメータで指定された予定表を表示します。

このメソッドは、MCM_SETCALID メッセージを送信します。このメッセージについては、Windows SDK を参照してください。

必要条件

ヘッダー : afxdtctl.h

このコントロールは、Windows Vista およびそれ以降のバージョンでサポートされています。

このメソッドに関するその他の要件については、「Windows Vista コモンコントロールの作成要件」を参照してください。

使用例

次のコード例では、プログラムによって月間予定表コントロールにアクセスするために使用される m_monthCalCtrl 変数を定義しています。この変数は、次の例で使用されます。

    // Variable used to reference the month calendar control.
    CMonthCalCtrl m_monthCalCtrl;
    // Variable used to reference the splitbutton control.
    CSplitButton m_splitButton;

次のコード例では、和暦の予定表を表示するように月間予定表コントロールを設定しています。SetCalID メソッドは、予定表がコンピュータにインストールされている場合にのみ正常に終了します。

    BOOL rc = m_monthCalCtrl.SetCalID(CAL_JAPAN);
    CString str = _T("Calendar change ");;
    if (rc == TRUE)
        str += _T("succeeded.");
    else {
        str += _T("failed.\n");
        str += _T("Perhaps this locale is not installed.");
    }
    AfxMessageBox(str, MB_ICONINFORMATION);