CMFCPropertyGridCtrl クラスがツールヒントの表示に使用するツールヒント コントロールを実装します。
構文
class CMFCPropertyGridToolTipCtrl : public CWnd
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl | CMFCPropertyGridToolTipCtrl オブジェクトを構築します。 |
CMFCPropertyGridToolTipCtrl::~CMFCPropertyGridToolTipCtrl |
デストラクターです。 |
パブリック メソッド
名前 | 説明 |
---|---|
CMFCPropertyGridToolTipCtrl::Create | ツールヒント コントロールのウィンドウを作成します。 |
CMFCPropertyGridToolTipCtrl::D eactivate | ツールヒント コントロールを非アクティブ化および非表示にします。 |
CMFCPropertyGridToolTipCtrl::GetLastRect | ツールヒント コントロールの最後の位置の座標を返します。 |
CMFCPropertyGridToolTipCtrl::Hide | ツールヒント コントロールを非表示にします。 |
CMFCPropertyGridToolTipCtrl::PreTranslateMessage |
TranslateMessage および DispatchMessage の各 Windows 関数にディスパッチされる前に、ウィンドウ メッセージを変換するためにクラス CWinApp で使用されます。 ( CWnd::PreTranslateMessageをオーバーライドします)。 |
CMFCPropertyGridToolTipCtrl::SetTextMargin | ヒント テキストとツールヒント ウィンドウの境界線の間隔を設定します。 |
CMFCPropertyGridToolTipCtrl::Track | ツールヒント コントロールを表示します。 |
解説
ヒントは、ポインターがプロパティ名に置かれたときに表示されます。 CMFCPropertyGridToolTipCtrl クラスは、ユーザーが簡単に読み取ることができるようにツールヒントを表示します。 通常、ヒントの位置はポインターの位置によって決まります。 このクラスを使用すると、プロパティ名の上にツールヒントが表示され、プロパティ名が完全に表示されるように、自然なプロパティ拡張に似ています。
MFC では、このコントロールが自動的に作成され、 CMFCPropertyGridCtrl クラスで使用されます。
例
次の例では、 CMFCPropertyGridToolTipCtrl
クラスのオブジェクトを構築する方法と、ツールヒント コントロールを表示する方法を示します。
CMFCPropertyGridToolTipCtrl *pToolTipCtrl = new CMFCPropertyGridToolTipCtrl();
CRect crect(1, 1, 50, 50);
pToolTipCtrl->Track(crect, _T("this is a tool tip control"));
継承階層
要件
Header: afxpropertygridtooltipctrl.h
CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl
CMFCPropertyGridToolTipCtrl
オブジェクトを構築します。
CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl();
CMFCPropertyGridToolTipCtrl::Create
ツールヒント コントロールのウィンドウを作成します。
BOOL Create(CWnd* pWndParent);
パラメーター
pWndParent
[in]親ウィンドウへのポインター。
戻り値
ウィンドウが正常に作成された場合は TRUE。それ以外の場合は FALSE。
CMFCPropertyGridToolTipCtrl::D eactivate
ツールヒント コントロールを非アクティブ化および非表示にします。
void Deactivate();
解説
このメソッドは、最後の位置とテキストを空の値に設定します。これにより、 CMFCPropertyGridToolTipCtrl::Track への今後の呼び出しにヒントが表示されます。
CMFCPropertyGridToolTipCtrl::GetLastRect
ツールヒント コントロールの最後の位置の座標を返します。
void GetLastRect(CRect& rect) const;
パラメーター
rect
[out]ツールヒント コントロールの最後の位置を格納します。
CMFCPropertyGridToolTipCtrl::Hide
ツールヒント コントロールを非表示にします。
void Hide();
CMFCPropertyGridToolTipCtrl::SetTextMargin
ヒント テキストとツールヒント ウィンドウの境界線の間隔を設定します。
void SetTextMargin(int nTextMargin);
パラメーター
nTextMargin
[in]ツールヒント コントロールのテキストとツールヒント ウィンドウの境界線の間隔を指定します。 既定値は 10 ピクセルです。
CMFCPropertyGridToolTipCtrl::Track
ツールヒント コントロールを表示します。
void Track(
CRect rect,
const CString& strText);
パラメーター
rect
[in]ツールヒント コントロールの位置とサイズを指定します。
strText
[in]ツールヒントに表示するテキストを指定します。
解説
このメソッドは、ツールヒント コントロールを、 rect で指定された位置とサイズで表示します。 このメソッドが最後に呼び出されてから位置、サイズ、およびテキストが変更されていない場合、このメソッドは無効になります。