CMFCLinkCtrl クラス
CMFCLinkCtrl クラスは、ボタンをハイパーリンクとして表示し、ボタンがクリックされたときにリンクのターゲットを呼び出します。
構文
class CMFCLinkCtrl : public CMFCButton
メンバー
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CMFCLinkCtrl::SetURL | 指定した URL をボタン テキストとして表示します。 |
| CMFCLinkCtrl::SetURLPrefix | URL の暗黙的なプロトコル (例: "http:") を設定します。 |
| CMFCLinkCtrl::SizeToContent | ボタンのテキストまたはビットマップを含むボタンのサイズを変更します。 |
保護メソッド
| 名前 | 説明 |
|---|---|
| CMFCLinkCtrl::OnDrawFocusRect | ボタンのフォーカス四角形が描画される前にフレームワークによって呼び出されます。 |
解説
CMFCLinkCtrl クラスから派生したボタンをクリックすると、フレームワークはボタンの URL をパラメーターとして ShellExecute メソッドに渡します。 次に、 ShellExecute メソッドによって URL のターゲットが開きます。
例
次の例では、 CMFCLinkCtrl オブジェクトのサイズを設定する方法と、 CMFCLinkCtrl オブジェクトに URL とヒントを設定する方法を示します。 この例は、 New Controls サンプルの一部です。
CMFCLinkCtrl m_btnLink;
m_btnLink.SetURL(_T("http://www.microsoft.com"));
m_btnLink.SetTooltip(_T("Visit Microsoft site"));
// resize the button to contain the button text or bitmap
m_btnLink.SizeToContent();
継承階層
要件
Header: afxlinkctrl.h
CMFCLinkCtrl::OnDrawFocusRect
ボタンのフォーカス四角形が描画される前にフレームワークによって呼び出されます。
virtual void OnDrawFocusRect(
CDC* pDC,
const CRect& rectClient);
パラメーター
pDC
[入力] デバイス コンテキストへのポインター。
rectClient
[in]リンク コントロールを囲む四角形。
解説
独自のコードを使用してボタンのフォーカス四角形を描画する場合は、このメソッドをオーバーライドします。
CMFCLinkCtrl::SetURL
指定した URL をボタン テキストとして表示します。
void SetURL(LPCTSTR lpszURL);
パラメーター
lpszURL
[in]表示するボタン テキスト。
解説
CMFCLinkCtrl::SetURLPrefix
URL の暗黙的なプロトコル (例: "http:") を設定します。
void SetURLPrefix(LPCTSTR lpszPrefix);
パラメーター
lpszPrefix
[in]URL プロトコルのプレフィックス。
解説
URL プレフィックスを設定するには、このメソッドを使用します。 プレフィックスはボタンの顔には表示されませんが、それを使用して URL のターゲットを参照できます。
CMFCLinkCtrl::SizeToContent
ボタンのテキストまたはビットマップを含むボタンのサイズを変更します。
virtual CSize SizeToContent(
BOOL bVCenter=FALSE,
BOOL bHCenter=FALSE);
パラメーター
bVCenter
[in]リンク コントロールの上部と下部の間でボタンのテキストとビットマップを垂直方向に中央揃えする場合は TRUE。それ以外の場合は FALSE。 既定値は FALSE です。
bHCenter
[in]リンク コントロールの左右の間でボタンのテキストとビットマップを水平方向に中央揃えする場合は TRUE。それ以外の場合は FALSE。 既定値は FALSE です。
戻り値
リンク コントロールの新しいサイズを格納する CSize オブジェクト。