CToolBarCtrl::GetState

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

更新 : 2007 年 11 月

ツールバーコントロールの指定したボタンの状態についての情報を取得します。たとえば、有効かどうか、押されたかどうか、オンになっているかどうかなどです。

int GetState(
   int nID 
) const;

パラメータ

nID
情報を取得するボタンのコマンド ID。

戻り値

正常終了した場合はボタンの状態情報を返します。それ以外の場合は -1 を返します。ボタンの状態情報は、CToolBarCtrl::AddButtons に示されている値の組み合わせになります。

解説

この関数はボタンの複数の状態を取得する場合に特に便利です。1 つの状態だけを取得するには、IsButtonEnabled、IsButtonChecked、IsButtonPressed、IsButtonHidden、または IsButtonIndeterminate のいずれか 1 つのメンバ関数を使います。ただし、TBSTATE_WRAP ボタン状態を取得できるのは GetState メンバ関数だけです。