CIPAddressCtrl-Klasse

Stellt die Funktionalität des allgemeinen Windows-Steuerelements für IP-Adressen bereit.

Syntax

class CIPAddressCtrl : public CWnd

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Ein IP-Adresssteuerelement, ein Steuerelement, das einem Bearbeitungssteuerelement ähnelt, ermöglicht es Ihnen, eine numerische Adresse im IP-Format (Internet Protocol) einzugeben und zu bearbeiten.

Dieses Steuerelement (und damit die Klasse) ist nur für Programme verfügbar, die CIPAddressCtrl unter Microsoft Internet Explorer 4.0 und höher ausgeführt werden. Sie werden auch unter zukünftigen Versionen von Windows und Windows NT verfügbar sein.

Allgemeine Informationen zum IP-Adresssteuerelement finden Sie unter IP-Adresssteuerelemente im Windows SDK.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Anforderungen

Header: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

Erstellt ein CIPAddressCtrl-Objekt.

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Löscht den Inhalt des IP-Adresssteuerelements.

void ClearAddress();

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachrichten-IPM_CLEARADDRESS, wie im Windows SDK beschrieben.

CIPAddressCtrl::Create

Erstellt ein IP-Adresssteuerelement und fügt es an ein CIPAddressCtrl Objekt an.

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

Parameter

dwStyle
Der Stil des IP-Adresssteuerelements. Wenden Sie eine Kombination aus Fensterformatvorlagen an. Sie müssen die WS_CHILD Formatvorlage einschließen, da das Steuerelement ein untergeordnetes Fenster sein muss. Eine Liste der Fensterstile finden Sie unter CreateWindow im Windows SDK.

rect
Ein Verweis auf die Größe und Position des IP-Adresssteuerelements. Es kann sich entweder um ein CRect-Objekt oder eine RECT-Struktur handeln.

pParentWnd
Ein Zeiger auf das übergeordnete Fenster des IP-Adresssteuerelements. Er darf nicht NULL sein.

Nid
Die ID des IP-Adresssteuerelements.

Rückgabewert

Nonzero, wenn die Initialisierung erfolgreich war; andernfalls 0.

Hinweise

Sie erstellen ein CIPAddressCtrl Objekt in zwei Schritten.

1. Rufen Sie den Konstruktor auf, der das CIPAddressCtrl Objekt erstellt.

2. Rufen Sie Createauf, wodurch das IP-Adresssteuerelement erstellt wird.

Wenn Sie erweiterte Fensterstile mit Ihrem Steuerelement verwenden möchten, rufen Sie CreateEx anstelle von Create.

CIPAddressCtrl::CreateEx

Rufen Sie diese Funktion auf, um ein Steuerelement (ein untergeordnetes Fenster) zu erstellen und es dem CIPAddressCtrl Objekt zuzuordnen.

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

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie unter dem dwExStyle-Parameter für CreateWindowEx im Windows SDK.

dwStyle
Der Stil des IP-Adresssteuerelements. Wenden Sie eine Kombination aus Fensterformatvorlagen an. Sie müssen die WS_CHILD Formatvorlage einschließen, da das Steuerelement ein untergeordnetes Fenster sein muss. Eine Liste der Fensterstile finden Sie unter CreateWindow im Windows SDK.

rect
Ein Verweis auf eine RECT-Struktur , die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten von pParentWnd beschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

Nid
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Verwenden Sie CreateEx anstelle von "Erstellen ", um erweiterte Windows-Formatvorlagen anzuwenden, die durch die erweiterte Windows-Formatvorlage WS_EX_ angegeben werden.

CIPAddressCtrl::GetAddress

Ruft die Adresswerte für alle vier Felder im IP-Adresssteuerelement ab.

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

int GetAddress(DWORD& dwAddress);

Parameter

nField0
Ein Verweis auf den Feldwert 0 aus einer verpackten IP-Adresse.

nField1
Ein Verweis auf den Feld 1-Wert aus einer verpackten IP-Adresse.

nField2
Ein Verweis auf den Feld-2-Wert aus einer verpackten IP-Adresse.

nField3
Ein Verweis auf den Feld 3-Wert aus einer verpackten IP-Adresse.

dwAddress
Ein Verweis auf die Adresse eines DWORD-Werts, der die IP-Adresse empfängt. Eine Tabelle, die zeigt, wie dwAddress gefüllt ist, finden Sie in den Hinweisen.

Rückgabewert

Die Anzahl der nicht leeren Felder im IP-Adresssteuerelement.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht IPM_GETADDRESS, wie im Windows SDK beschrieben. Im ersten Prototyp oben füllen die Zahlen in Feldern 0 bis 3 des Steuerelements, von links nach rechts gelesen bzw. die vier Parameter auf. Im zweiten Prototyp oben wird dwAddress wie folgt aufgefüllt.

CIPAddressCtrl::IsBlank

Bestimmt, ob alle Felder im IP-Adresssteuerelement leer sind.

BOOL IsBlank() const;

Rückgabewert

Nonzero, wenn alle Felder des IP-Adresssteuerelements leer sind; andernfalls 0.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachrichten-IPM_ISBLANK, wie im Windows SDK beschrieben.

CIPAddressCtrl::SetAddress

Legt die Adresswerte für alle vier Felder im IP-Adresssteuerelement fest.

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

void SetAddress(DWORD dwAddress);

Parameter

nField0
Der Feldwert 0 aus einer verpackten IP-Adresse.

nField1
Der Feldwert 1 aus einer verpackten IP-Adresse.

nField2
Der Feldwert 2 aus einer verpackten IP-Adresse.

nField3
Der Feldwert 3 aus einer verpackten IP-Adresse.

dwAddress
Ein DWORD-Wert, der die neue IP-Adresse enthält. Eine Tabelle, die zeigt, wie der DWORD-Wert gefüllt wird, finden Sie in den Hinweisen .

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht IPM_SETADDRESS, wie im Windows SDK beschrieben. Im ersten Prototyp oben füllen die Zahlen in Feldern 0 bis 3 des Steuerelements, von links nach rechts gelesen bzw. die vier Parameter auf. Im zweiten Prototyp oben wird dwAddress wie folgt aufgefüllt.

CIPAddressCtrl::SetFieldFocus

Legt den Tastaturfokus auf das angegebene Feld im IP-Adresssteuerelement fest.

void SetFieldFocus(WORD nField);

Parameter

nField
Nullbasierter Feldindex, auf den der Fokus festgelegt werden soll. Wenn dieser Wert größer als die Anzahl der Felder ist, wird der Fokus auf das erste leere Feld festgelegt. Wenn alle Felder nicht leer sind, wird der Fokus auf das erste Feld festgelegt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht IPM_SETFOCUS, wie im Windows SDK beschrieben.

CIPAddressCtrl::SetFieldRange

Legt den Bereich im angegebenen Feld im IP-Adresssteuerelement fest.

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

Parameter

nField
Nullbasierter Feldindex, auf den der Bereich angewendet wird.

nLower
Ein Verweis auf eine ganze Zahl, die die untere Grenze des angegebenen Felds in diesem IP-Adresssteuerelement empfängt.

nUpper
Ein Verweis auf eine ganze Zahl, die die obere Grenze des angegebenen Felds in diesem IP-Adresssteuerelement empfängt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht IPM_SETRANGE, wie im Windows SDK beschrieben. Verwenden Sie die beiden Parameter nLower und nUpper, um die unteren und oberen Grenzwerte des Felds anstelle des wRange-Parameters anzugeben, der mit der Win32-Nachricht verwendet wird.

Siehe auch

CWnd-Klasse
Hierarchiediagramm