CIPAddressCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A Windows általános IP-cím vezérlőjének funkcióit biztosítja.

Szemantika

class CIPAddressCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Description
CIPAddressCtrl::CIPAddressCtrl	Egy CIPAddressCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Description
CIPAddressCtrl::ClearAddress	Törli az IP-címvezérlő tartalmát.
CIPAddressCtrl::Létrehozás	Létrehoz egy IP-címvezérlőt, és csatolja egy CIPAddressCtrl objektumhoz.
CIPAddressCtrl::CreateEx	Létrehoz egy IP-cím vezérlőelemet a megadott Bővített Windows-stílusokkal, és csatolja egy CIPAddressCtrl objektumhoz.
CIPAddressCtrl::GetAddress	Lekéri az IP-címvezérlő mind a négy mezőjének címértékeit.
CIPAddressCtrl::IsBlank	Meghatározza, hogy az IP-címvezérlő összes mezője üres-e.
CIPAddressCtrl::SetAddress	Beállítja az IP-címvezérlő mind a négy mezőjének címértékét.
CIPAddressCtrl::SetFieldFocus	Beállítja a billentyűzetfókuszt az IP-címvezérlő megadott mezőjére.
CIPAddressCtrl::SetFieldRange	Beállítja a tartományt az IP-címvezérlő megadott mezőjében.

Megjegyzések

A szerkesztési vezérlőhöz hasonló IP-cím vezérlőelem lehetővé teszi, hogy numerikus címeket írjon be és kezeljen IP-formátumban.

Ez a vezérlő (és ezért az CIPAddressCtrl osztály) csak a Microsoft Internet Explorer 4.0-s és újabb verzióiban futó programok számára érhető el. A Windows és a Windows NT későbbi verzióiban is elérhetők lesznek.

Az IP-címvezérlőről további információt a Windows SDK IP-címvezérlői című témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Requirements

Fejléc: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

Létrehoz egy objektumot CIPAddressCtrl .

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Törli az IP-címvezérlő tartalmát.

void ClearAddress();

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_CLEARADDRESS viselkedését a Windows SDK-ban leírtak szerint.

CIPAddressCtrl::Létrehozás

Létrehoz egy IP-címvezérlőt, és csatolja egy CIPAddressCtrl objektumhoz.

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

Paraméterek

dwStyle
Az IP-cím vezérlőelem stílusa. Az ablakstílusok kombinációjának alkalmazása. Meg kell adnia a WS_CHILD stílust, mert a vezérlőnek gyermekablaknak kell lennie. A Windows SDK-ban a CreateWindow című témakörben találja a Windows-stílusok listáját.

téglalap
Hivatkozás az IP-címvezérlő méretére és helyzetére. Lehet CRect objektum vagy RECT-struktúra .

pParentWnd
Mutató az IP-címvezérlő szülőablakára. Nem lehet NULL.

nID
Az IP-címvezérlő azonosítója.

Visszaadott érték

Nonzero, ha az inicializálás sikeres volt; egyéb esetben 0.

Megjegyzések

Egy objektumot CIPAddressCtrl két lépésben hozhat létre.

1. Hívja meg a konstruktort, amely létrehozza az CIPAddressCtrl objektumot.

2. Hívás Create, amely létrehozza az IP-címvezérlőt.

Ha a vezérlővel bővített ablakstílusokat szeretne használni, ahelyett hívja meg a CreateCreateExet.

CIPAddressCtrl::CreateEx

A függvény meghívásával hozzon létre egy vezérlőt (egy gyermekablakot), és társítsa azt az CIPAddressCtrl objektummal.

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

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a CreateWindowExdwExStyle paraméterében találja a Windows SDK-ban.

dwStyle
Az IP-cím vezérlőelem stílusa. Az ablakstílusok kombinációjának alkalmazása. Meg kell adnia a WS_CHILD stílust, mert a vezérlőnek gyermekablaknak kell lennie. A Windows SDK-ban a CreateWindow című témakörben találja a Windows-stílusok listáját.

téglalap
Hivatkozás a létrehozandó ablak méretét és pozícióját leíró RECT-struktúrára a pParentWnd ügyfélkoordinátáiban.

pParentWnd
A vezérlő szülőablakára mutató mutató.

nID
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A CreateExLétrehozás helyett kiterjesztett Windows-stílusokat alkalmazhat, amelyeket a Windows bővített stílus előszavában WS_EX_.

CIPAddressCtrl::GetAddress

Lekéri az IP-címvezérlő mind a négy mezőjének címértékeit.

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

int GetAddress(DWORD& dwAddress);

Paraméterek

nField0
Hivatkozás a 0 mező értékére egy csomagolt IP-címből.

nField1
Hivatkozás az 1. mező értékére egy csomagolt IP-címből.

nField2
Hivatkozás a 2. mező értékére egy csomagolt IP-címből.

nField3
Hivatkozás a 3. mező értékére egy csomagolt IP-címből.

dwAddress
Hivatkozás az IP-címet fogadó DWORD-érték címére. A dwAddress kitöltését bemutató táblázat megjegyzései.

Visszaadott érték

Az IP-címvezérlő nem üres mezőinek száma.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_GETADDRESS viselkedését a Windows SDK-ban leírtak szerint. A fenti első prototípusban a vezérlő 0–3. mezőjében a balról jobbra beolvasott számok kitöltik a négy paramétert. A fenti második prototípusban a dwAddress a következőképpen van feltöltve.

szakterület	A mező értékét tartalmazó bitek
0	24–31
1	16–23
2	8–15
3	0–7

CIPAddressCtrl::IsBlank

Meghatározza, hogy az IP-címvezérlő összes mezője üres-e.

BOOL IsBlank() const;

Visszaadott érték

Nem kötelező, ha az ÖSSZES IP-címvezérlő mező üres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_ISBLANK viselkedését a Windows SDK-ban leírtak szerint.

CIPAddressCtrl::SetAddress

Beállítja az IP-címvezérlő mind a négy mezőjének címértékét.

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

void SetAddress(DWORD dwAddress);

Paraméterek

nField0
A 0 mező értéke egy csomagolt IP-címből.

nField1
Az 1. mező értéke egy csomagolt IP-címből.

nField2
A 2. mező értéke egy csomagolt IP-címből.

nField3
A 3. mező értéke egy csomagolt IP-címből.

dwAddress
Az új IP-címet tartalmazó DWORD-érték. A DWORD érték kitöltését bemutató táblázat megjegyzései .

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_SETADDRESS viselkedését a Windows SDK-ban leírtak szerint. A fenti első prototípusban a vezérlő 0–3. mezőjében a balról jobbra beolvasott számok kitöltik a négy paramétert. A fenti második prototípusban a dwAddress a következőképpen van feltöltve.

szakterület	A mező értékét tartalmazó bitek
0	24–31
1	16–23
2	8–15
3	0–7

CIPAddressCtrl::SetFieldFocus

Beállítja a billentyűzetfókuszt az IP-címvezérlő megadott mezőjére.

void SetFieldFocus(WORD nField);

Paraméterek

nMező
Nulla alapú mezőindex, amelyre a fókuszt be kell állítani. Ha ez az érték nagyobb, mint a mezők száma, a fókusz az első üres mezőre van állítva. Ha minden mező nem üres, a fókusz az első mezőre van állítva.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_SETFOCUS viselkedését a Windows SDK-ban leírtak szerint.

CIPAddressCtrl::SetFieldRange

Beállítja a tartományt az IP-címvezérlő megadott mezőjében.

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

Paraméterek

nMező
Nulla alapú mezőindex, amelyre a tartományt alkalmazni fogja.

nLower
Hivatkozás egy olyan egész számra, amely a megadott mező alsó korlátját kapja ebben az IP-címvezérlőben.

nUpper
Hivatkozás egy egész számra, amely a megadott mező felső korlátját kapja ebben az IP-címvezérlőben.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet IPM_SETRANGE viselkedését a Windows SDK-ban leírtak szerint. Használja az nLower és az nUpper paramétert a mező alsó és felső korlátainak jelzéséhez a Win32-üzenetben használt wRange paraméter helyett.

Lásd még

CWnd osztály
hierarchiadiagram