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 エクスプローラー 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。

解説

2 つの手順でオブジェクトを CIPAddressCtrl 構築します。

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

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

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

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
pParentWnd のクライアント座標における、作成するウィンドウのサイズと位置を記述する RECT 構造体への参照。

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

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

戻り値

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

解説

Windows 拡張スタイルの前置WS_EX_で指定された拡張 Windows スタイルを適用するには、[作成] の代わりに使用CreateExします。

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 の塗りつぶし方法を示す表については、「解説」を参照してください。

戻り値

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 値の入力方法を示す表については、「解説」を参照してください。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ IPM_Standard Edition TADDRESS の動作を実装します。 上記の最初のプロトタイプでは、コントロールのフィールド 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_Standard Edition TFOCUS の動作を実装します。

CIPAddressCtrl::SetFieldRange

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

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

パラメーター

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

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

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

解説

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

関連項目

CWnd クラス
階層図