次の方法で共有

CIPAddressCtrl クラス

  • [アーティクル]

Windows コモン IP アドレス コントロールの機能が用意されています。

構文

class CIPAddressCtrl : public CWnd

メンバー

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

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

パブリック メソッド

名前 説明
CIPAddressCtrl::ClearAddress IP アドレス コントロールの内容をクリアします。
CIPAddressCtrl::Create IP アドレス コントロールを作成し、 CIPAddressCtrl オブジェクトにアタッチします。
CIPAddressCtrl::CreateEx 指定した Windows 拡張スタイルを使用して IP アドレス コントロールを作成し、 CIPAddressCtrl オブジェクトにアタッチします。
CIPAddressCtrl::GetAddress IP アドレス コントロールの 4 つのフィールドすべてに対するアドレス値を取得します。
CIPAddressCtrl::IsBlank IP アドレス制御のすべてのフィールドが空かどうかを判断します。
CIPAddressCtrl::SetAddress IP アドレス コントロールの 4 つのフィールドすべてに対してアドレス値を設定します。
CIPAddressCtrl::SetFieldFocus IP アドレス コントロールの指定したフィールドにキーボード フォーカスを設定します。
CIPAddressCtrl::SetFieldRange IP アドレス コントロールの指定したフィールドの範囲を設定します。

解説

IP アドレス コントロールは、編集コントロールに似たコントロールで、インターネット プロトコル (IP) 形式で数値アドレスを入力および操作できます。

このコントロール (したがって、 CIPAddressCtrl クラス) は、Microsoft Internet Explorer 4.0 以降で実行されているプログラムでのみ使用できます。 今後のバージョンの Windows および Windows NT でも使用できるようになります。

IP アドレス制御の詳細については、Windows SDK の「 IP アドレス制御 」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CIPAddressCtrl

要件

ヘッダー: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

CIPAddressCtrl オブジェクトを作成します。

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

IP アドレス コントロールの内容をクリアします。

void ClearAddress();

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_CLEARADDRESSの動作を実装します。

CIPAddressCtrl::Create

IP アドレス コントロールを作成し、 CIPAddressCtrl オブジェクトにアタッチします。

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

パラメーター

dwStyle
IP アドレス コントロールのスタイル。 ウィンドウ スタイルの組み合わせを適用します。 コントロールは子ウィンドウである必要があるため、WS_CHILD スタイルを含める必要があります。 Windows スタイルの一覧については、Windows SDK の CreateWindow を参照してください。

rect
IP アドレス コントロールのサイズと位置への参照。 CRect オブジェクトまたは RECT 構造体のいずれかを指定できます。

pParentWnd
IP アドレス コントロールの親ウィンドウへのポインター。 NULL は指定できません。

nID
IP アドレス コントロールの ID。

戻り値

初期化が成功した場合は 0 以外。それ以外の場合は 0。

解説

CIPAddressCtrl オブジェクトは、2 つの手順で作成します。

  1. コンストラクターを呼び出して、 CIPAddressCtrl オブジェクトを作成します。

  2. を呼び出して、IP アドレス制御を作成します。

コントロールで拡張ウィンドウ スタイルを使用する場合は、Createの代わりに CreateEx を呼び出します。

CIPAddressCtrl::CreateEx

この関数を呼び出してコントロール (子ウィンドウ) を作成し、 CIPAddressCtrl オブジェクトに関連付けます。

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

パラメーター

dwExStyle
作成するコントロールの拡張スタイルを指定します。 拡張 Windows スタイルの一覧については、Windows SDK の CreateWindowEx の dwExStyle パラメーターを参照してください。

dwStyle
IP アドレス コントロールのスタイル。 ウィンドウ スタイルの組み合わせを適用します。 コントロールは子ウィンドウである必要があるため、WS_CHILD スタイルを含める必要があります。 Windows スタイルの一覧については、Windows SDK の CreateWindow を参照してください。

rect
作成するウィンドウのサイズと位置を記述する RECT 構造体への参照 ( pParentWnd のクライアント座標)。

pParentWnd
コントロールの親であるウィンドウへのポインター。

nID
コントロールの子ウィンドウ ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

Create の代わりにCreateExを使用して、Windows 拡張スタイルの前書きWS_EX_で指定された拡張 Windows スタイルを適用します。

CIPAddressCtrl::GetAddress

IP アドレス コントロールの 4 つのフィールドすべてに対するアドレス値を取得します。

int GetAddress(
    BYTE& nField0,
    BYTE& nField1,
    BYTE& nField2,
    BYTE& nField3);

int GetAddress(DWORD& dwAddress);

パラメーター

nField0
パックされた IP アドレスからのフィールド 0 値への参照。

nField1
パックされた IP アドレスからのフィールド 1 値への参照。

nField2
パックされた IP アドレスからのフィールド 2 値への参照。

nField3
パックされた IP アドレスからのフィールド 3 値への参照。

dwAddress
IP アドレスを受け取る DWORD 値のアドレスへの参照。 dwAddressの塗りつぶし方法を示す表については、「Remarks」を参照してください。

戻り値

IP アドレスコントロール内の空白以外のフィールドの数。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_GETADDRESSの動作を実装します。 上記の最初のプロトタイプでは、コントロールのフィールド 0 から 3 の数値をそれぞれ左から右に読み取り、4 つのパラメーターを設定します。 上記の 2 番目のプロトタイプでは、 dwAddress が次のように設定されています。

フィールド フィールド値を含むビット
0 24 ~ 31
1 16 ~ 23
2 8 ~ 15
3 0 ~ 7

CIPAddressCtrl::IsBlank

IP アドレス制御のすべてのフィールドが空かどうかを判断します。

BOOL IsBlank() const;

戻り値

すべての IP アドレス制御フィールドが空の場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_ISBLANKの動作を実装します。

CIPAddressCtrl::SetAddress

IP アドレス コントロールの 4 つのフィールドすべてに対してアドレス値を設定します。

void SetAddress(
    BYTE nField0,
    BYTE nField1,
    BYTE nField2,
    BYTE nField3);

void SetAddress(DWORD dwAddress);

パラメーター

nField0
パックされた IP アドレスのフィールド 0 の値。

nField1
パックされた IP アドレスのフィールド 1 の値。

nField2
パックされた IP アドレスのフィールド 2 の値。

nField3
パックされた IP アドレスのフィールド 3 の値。

dwAddress
新しい IP アドレスを含む DWORD 値。 DWORD 値の入力方法を示す表については、「 Remarks 」を参照してください。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_SETADDRESSの動作を実装します。 上記の最初のプロトタイプでは、コントロールのフィールド 0 から 3 の数値をそれぞれ左から右に読み取り、4 つのパラメーターを設定します。 上記の 2 番目のプロトタイプでは、 dwAddress が次のように設定されています。

フィールド フィールド値を含むビット
0 24 ~ 31
1 16 ~ 23
2 8 ~ 15
3 0 ~ 7

CIPAddressCtrl::SetFieldFocus

IP アドレス コントロールの指定したフィールドにキーボード フォーカスを設定します。

void SetFieldFocus(WORD nField);

パラメーター

nField
フォーカスを設定する 0 から始まるフィールド インデックス。 この値がフィールドの数より大きい場合、フォーカスは最初の空白フィールドに設定されます。 すべてのフィールドが空白でない場合、フォーカスは最初のフィールドに設定されます。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_SETFOCUSの動作を実装します。

CIPAddressCtrl::SetFieldRange

IP アドレス コントロールの指定したフィールドの範囲を設定します。

void SetFieldRange(
    int nField,
    BYTE nLower,
    BYTE nUpper);

パラメーター

nField
範囲が適用される 0 から始まるフィールド インデックス。

nLower
この IP アドレス制御で指定されたフィールドの下限を受け取る整数への参照。

nUpper
この IP アドレス制御で指定されたフィールドの上限を受け取る整数への参照。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_SETRANGEの動作を実装します。 Win32 メッセージで使用される wRange パラメーターではなく、フィールドの下限と上限を示すには、nLower と nUpper の 2 つのパラメーターを使用します。

関連項目

CWnd クラス
階層図