CIPAddressCtrl-Klasse
Stellt die Funktionalität des allgemeinen Windows-Steuerelements für IP-Adressen bereit.
Syntax
class CIPAddressCtrl : public CWnd
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | Erstellt ein CIPAddressCtrl-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CIPAddressCtrl::ClearAddress | Löscht den Inhalt des IP-Adresssteuerelements. |
| CIPAddressCtrl::Create | Erstellt ein IP-Adresssteuerelement und fügt es an ein CIPAddressCtrl Objekt an. |
| CIPAddressCtrl::CreateEx | Erstellt ein IP-Adresssteuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an ein CIPAddressCtrl Objekt an. |
| CIPAddressCtrl::GetAddress | Ruft die Adresswerte für alle vier Felder im IP-Adresssteuerelement ab. |
| CIPAddressCtrl::IsBlank | Bestimmt, ob alle Felder im IP-Adresssteuerelement leer sind. |
| CIPAddressCtrl::SetAddress | Legt die Adresswerte für alle vier Felder im IP-Adresssteuerelement fest. |
| CIPAddressCtrl::SetFieldFocus | Legt den Tastaturfokus auf das angegebene Feld im IP-Adresssteuerelement fest. |
| CIPAddressCtrl::SetFieldRange | Legt den Bereich im angegebenen Feld im IP-Adresssteuerelement fest. |
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
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.
Rufen Sie den Konstruktor auf, der das
CIPAddressCtrlObjekt erstellt.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.
| Feld | Bits, die den Feldwert enthalten |
|---|---|
| 0 | 24 bis 31 |
| 1 | 16 bis 23 |
| 2 | 8 bis 15 |
| 3 | 0 bis 7 |
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.
| Feld | Bits, die den Feldwert enthalten |
|---|---|
| 0 | 24 bis 31 |
| 1 | 16 bis 23 |
| 2 | 8 bis 15 |
| 3 | 0 bis 7 |
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für