CMFCToolTipCtrl クラス
更新 : 2007 年 11 月
CToolTipCtrl クラスに基づいた拡張ツールヒントの実装です。CMFCToolTipCtrl クラスに基づいたツールヒントは、アイコン、ラベル、および説明を表示できます。グラデーション塗りつぶし、カスタム テキストと境界線の色、太字、丸い角、またはバルーン形式を使用して、外観をカスタマイズできます。
class CMFCToolTipCtrl : public CToolTipCtrl
メンバ
パブリック コンストラクタ
名前 |
説明 |
|---|---|
CMFCToolTipCtrl::CMFCToolTipCtrl |
既定のコンストラクタです。 |
パブリック メソッド
名前 |
説明 |
|---|---|
ツールヒントのアイコンのサイズを返します。 |
|
ツールヒントの表示設定を返します。 |
|
ツールヒントの境界線を描画します。 |
|
|
|
ツールヒントにアイコンを表示します。 |
|
ツールヒントのラベルを描画するか、ラベルのサイズを計算します。 |
|
ツールヒントのラベルと説明との間の区分線を描画します。 |
|
ツールヒントの背景を塗りつぶします。 |
|
ツールヒントによって表示される説明を設定します。 |
|
|
|
|
|
|
|
CMFCToolTipInfo オブジェクトを使用して、ツールヒントの外観を指定します。 |
解説
CMFCToolTipCtrl、CMFCToolTipInfo、および CTooltipManager クラス の各オブジェクトを併用して、カスタマイズされたツールヒントをアプリケーションに実装します。
たとえば、バルーン形式のツールヒントを使用するには、次の手順を実行します。
1. CWinAppEx クラス メソッドを使用して、アプリケーションのツールヒント マネージャを初期化します。
2. CMFCToolTipInfo 構造体を作成して、目的の表示スタイルを指定します。
CMFCToolTipInfo params;
params.m_bBoldLabel = FALSE;
params.m_bDrawDescription = FALSE;
params.m_bDrawIcon = FALSE;
params.m_bRoundedCorners = TRUE;
params.m_bDrawSeparator = FALSE;
if (m_bCustomColors)
{
params.m_clrFill = RGB (255, 255, 255);
params.m_clrFillGradient = RGB (228, 228, 240);
params.m_clrText = RGB (61, 83, 80);
params.m_clrBorder = RGB (144, 149, 168);
}
3. アプリケーション内のすべてのツールヒントに CMFCToolTipInfo オブジェクトで定義したスタイルを使用して表示スタイルを設定するには、CTooltipManager::SetTooltipParams メソッドを使用します。
theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
RUNTIME_CLASS (CMFCToolTipCtrl), ¶ms);
また、CMFCToolTipCtrl から新しいクラスを派生させて、ツールヒントの動作とレンダリングを制御することもできます。新しいツールヒント コントロール クラスを指定するには、CTooltipManager::SetTooltipParams メソッドを使用します。
myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
RUNTIME_CLASS (CMyToolTipCtrl))
既定のツールヒント コントロール クラスを復元し、ツールヒントの外観をその既定の状態にリセットするには、ランタイム クラスと SetTooltipParams ツールヒント情報パラメータに NULL を指定します。
theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
NULL, NULL);
使用例
CMFCToolTipCtrl オブジェクトの構築、ツールヒントに表示される説明の設定、およびツールヒント コントロールの幅の設定方法を次の例に示します。
CMFCToolTipInfo* params = new CMFCToolTipInfo();
params->m_bBoldLabel = FALSE;
params->m_bDrawDescription = FALSE;
params->m_bDrawIcon = FALSE;
params->m_bRoundedCorners = TRUE;
params->m_bDrawSeparator = FALSE;
params->m_clrFill = RGB (255, 255, 255);
params->m_clrFillGradient = RGB (228, 228, 240);
params->m_clrText = RGB (61, 83, 80);
params->m_clrBorder = RGB (144, 149, 168);
CMFCToolTipCtrl* tipCtrl = new CMFCToolTipCtrl(params);
tipCtrl->SetDescription(_T("tool tip control"));
tipCtrl->SetFixedWidth(100,150);
継承階層
必要条件
ヘッダー : afxtooltipctrl.h