CNetAddressCtrl クラス

CNetAddressCtrl クラスは、ネットワーク アドレス コントロールを表します。このコントロールを使用すると、IPv4 アドレス、IPv6 アドレス、および名前付き DNS アドレスの形式を入力して検証できます。

class CNetAddressCtrl : public CEdit

メンバー

パブリック コンストラクター

名前	説明
CNetAddressCtrl::CNetAddressCtrl	CNetAddressCtrl オブジェクトを構築します。

パブリック メソッド

名前	説明
CNetAddressCtrl::Create	指定されたスタイルのネットワーク アドレス コントロールを作成し、CNetAddressCtrl の現在のオブジェクトにアタッチします。
CNetAddressCtrl::CreateEx	指定された拡張スタイルのネットワーク アドレス コントロールを作成し、CNetAddressCtrl の現在のオブジェクトにアタッチします。
CNetAddressCtrl::DisplayErrorTip	ユーザーが現在のネットワーク アドレス コントロールでサポートされていないネットワーク アドレスを入力するとエラーにバルーン ヒントを表示します。
CNetAddressCtrl::GetAddress	現在のネットワーク アドレス コントロールに関連付けられているネットワーク アドレスの検証され、解析された表現を取得します。
CNetAddressCtrl::GetAllowType	サポートする現在のネットワーク アドレス コントロールができるネットワーク アドレスの種類を取得します。
CNetAddressCtrl::SetAllowType	サポートする現在のネットワーク アドレス コントロールができるネットワーク アドレスの種類を設定します。

解説

ネットワーク アドレス コントロールは、ユーザーが入力したアドレスの形式が正しいことを確認します。コントロールは、ネットワーク アドレスに実際に接続しません。CNetAddressCtrl::SetAllowType のメソッドは CNetAddressCtrl::GetAddress の検証メソッドが解析してアドレスの一つ以上の型を指定します。アドレスは、ネットワーク サーバー、ホスト、またはブロードキャスト メッセージの出力先の IPv4、IPv6、または名前付きのアドレスの形式になります。アドレスの形式が正しくない場合、ネットワーク アドレス コントロールのテキスト ボックスをグラフィカルにポイントして、定義済みのエラー メッセージを表示するヒントのメッセージ ボックスを表示するに CNetAddressCtrl::DisplayErrorTip のメソッドを使用できます。

CNetAddressCtrl のクラスは CEdit のクラスから派生します。その結果、ネットワーク アドレス コントロールは、すべての Windows のエディット コントロールのメッセージへのアクセスを提供します。

次の図は、ネットワーク アドレス コントロールをダイアログを示しています。ネットワーク アドレス コントロールのテキスト ボックス (1) が無効なネットワーク アドレスを格納します。ネットワーク アドレスが有効でない場合は (2) ヒント メッセージが表示されます。

使用例

次のコード例は、ネットワーク アドレスを検証するダイアログの一部です。3 個のラジオ ボタンのイベント ハンドラーは、ネットワーク アドレスが 3 台のアドレスの 1 種類の一つであることを指定します。ユーザーは、ネットワーク アドレス コントロールのテキスト ボックスには、されたアドレスを検証するためにボタンを押します。アドレスが有効な場合、成功メッセージが表示されます。; は、定義済みのツールヒントのエラー メッセージが表示されます。

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio1()
{
    m_netAddr.SetAllowType(NET_STRING_IPV4_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio2()
{
    m_netAddr.SetAllowType(NET_STRING_IPV6_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio3()
{
    m_netAddr.SetAllowType(NET_STRING_NAMED_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedButton1()
{
    m_na.pAddrInfo = &m_nai;
    HRESULT rslt = m_netAddr.GetAddress(&m_na);
    if (rslt != S_OK)
        m_netAddr.DisplayErrorTip();
    else
    {
        MessageBox(
            _T("Success!"), _T("Validation Results"));
    }

ダイアログのヘッダー ファイルの次のコード例は CNetAddressCtrl::GetAddress のメソッドに必要な NC_ADDRESS と NET_ADDRESS_INFO の変数を定義します。

    NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

継承階層

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

必要条件

ヘッダー: afxcmn.h

このクラスは Windows Vista 以降でサポートされます。

このクラスの追加要件は Windows Vista コモン コントロールの作成要件で説明します。

参照

関連項目

CNetAddressCtrl クラス

階層図

CEdit クラス