CIPAddressCtrl – třída
Poskytuje funkce běžného řízení IP adres systému Windows.
Syntaxe
class CIPAddressCtrl : public CWnd
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | CIPAddressCtrl Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CIPAddressCtrl::ClearAddress | Vymaže obsah ovládacího prvku IP adresy. |
| CIPAddressCtrl::Create | Vytvoří ovládací prvek IP adresy a připojí ho k objektu CIPAddressCtrl . |
| CIPAddressCtrl::CreateEx | Vytvoří ovládací prvek IP adresy se zadanými rozšířenými styly Windows a připojí ho k objektu CIPAddressCtrl . |
| CIPAddressCtrl::GetAddress | Načte hodnoty adresy pro všechna čtyři pole v ovládacím prvku IP adresa. |
| CIPAddressCtrl::IsBlank | Určuje, jestli jsou všechna pole v ovládacím prvku IP adres prázdná. |
| CIPAddressCtrl::SetAddress | Nastaví hodnoty adresy pro všechna čtyři pole v ovládacím prvku IP adresy. |
| CIPAddressCtrl::SetFieldFocus | Nastaví fokus klávesnice na zadané pole v ovládacím prvku IP adresy. |
| CIPAddressCtrl::SetFieldRange | Nastaví rozsah v zadaném poli v ovládacím prvku IP adresy. |
Poznámky
Ovládací prvek IP adresy, ovládací prvek podobný ovládacímu prvku pro úpravy, umožňuje zadat a manipulovat s číselnou adresou ve formátu IP (Internet Protocol).
Tento ovládací prvek (a proto CIPAddressCtrl třída) je k dispozici pouze pro programy spuštěné v aplikaci Microsoft Internet Explorer 4.0 a novější. Budou také k dispozici v budoucích verzích Windows a systém Windows NT.
Další obecné informace o ovládacím prvku IP adres naleznete v tématu Ovládací prvky IP adres v sadě Windows SDK.
Hierarchie dědičnosti
CIPAddressCtrl
Požadavky
Hlavička: afxcmn.h
CIPAddressCtrl::CIPAddressCtrl
CIPAddressCtrl Vytvoří objekt.
CIPAddressCtrl();
CIPAddressCtrl::ClearAddress
Vymaže obsah ovládacího prvku IP adresy.
void ClearAddress();
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_CLEARADDRESS, jak je popsáno v sadě Windows SDK.
CIPAddressCtrl::Create
Vytvoří ovládací prvek IP adresy a připojí ho k objektu CIPAddressCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametry
dwStyle
Styl ovládacího prvku IP adresy. Použijte kombinaci stylů oken. Musíte zahrnout styl WS_CHILD, protože ovládací prvek musí být podřízeným oknem. Seznam stylů oken najdete v tématu CreateWindow v sadě Windows SDK.
Rect
Odkaz na velikost a pozici ovládacího prvku IP adres. Může to být objekt CRect nebo struktura RECT .
pParentWnd
Ukazatel na nadřazené okno ovládacího prvku IP adres Nesmí mít hodnotu NULL.
Nid
ID ovládacího prvku IP adresy.
Návratová hodnota
Nenulové, pokud byla inicializace úspěšná; jinak 0.
Poznámky
Objekt vytvoříte CIPAddressCtrl ve dvou krocích.
Volání konstruktoru, který vytvoří
CIPAddressCtrlobjekt.Volání
Create, které vytvoří řízení IP adresy.
Chcete-li použít rozšířené styly oken s ovládacím prvek, volání CreateEx místo Create.
CIPAddressCtrl::CreateEx
Voláním této funkce vytvoříte ovládací prvek (podřízené okno) a přidružíte ho k objektu CIPAddressCtrl .
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametry
dwExStyle
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů Windows naleznete v části dwExStyle parametr pro CreateWindowEx v sadě Windows SDK.
dwStyle
Styl ovládacího prvku IP adresy. Použijte kombinaci stylů oken. Musíte zahrnout styl WS_CHILD, protože ovládací prvek musí být podřízeným oknem. Seznam stylů oken najdete v tématu CreateWindow v sadě Windows SDK.
Rect
Odkaz na strukturu RECT popisující velikost a umístění okna, které se má vytvořit, v souřadnicích klienta pParentWnd.
pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.
Nid
ID podřízeného okna ovládacího prvku.
Návratová hodnota
Nenulové, pokud je úspěšné; jinak 0.
Poznámky
Místo příkazu Vytvořit použijte CreateEx rozšířené styly Windows určené před WS_EX_ rozšířeného stylu Windows.
CIPAddressCtrl::GetAddress
Načte hodnoty adresy pro všechna čtyři pole v ovládacím prvku IP adresa.
int GetAddress(
BYTE& nField0,
BYTE& nField1,
BYTE& nField2,
BYTE& nField3);
int GetAddress(DWORD& dwAddress);
Parametry
nField0
Odkaz na hodnotu pole 0 z zabalené IP adresy.
nField1
Odkaz na hodnotu pole 1 z zabalené IP adresy.
nField2
Odkaz na hodnotu pole 2 z zabalené IP adresy.
nField3
Odkaz na hodnotu pole 3 z zabalené IP adresy.
DwAddress
Odkaz na adresu hodnoty DWORD, která obdrží IP adresu. Viz Poznámky pro tabulku, která ukazuje, jak je dwAddress vyplněna.
Návratová hodnota
Počet neprázdných polí v ovládacím prvku IP adresy.
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_GETADDRESS, jak je popsáno v sadě Windows SDK. V prvním prototypu výše čísla v polích 0 až 3 ovládacího prvku přečtou zleva doprava a naplní čtyři parametry. V druhém prototypu výše se dwAddress vyplní následujícím způsobem.
| Pole | Bity obsahující hodnotu pole |
|---|---|
| 0 | 24 až 31 |
| 0 | 16 až 23 |
| 2 | 8 až 15 |
| 3 | 0 až 7 |
CIPAddressCtrl::IsBlank
Určuje, jestli jsou všechna pole v ovládacím prvku IP adres prázdná.
BOOL IsBlank() const;
Návratová hodnota
Nenulové, pokud jsou všechna pole řízení IP adres prázdná; jinak 0.
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_ISBLANK, jak je popsáno v sadě Windows SDK.
CIPAddressCtrl::SetAddress
Nastaví hodnoty adresy pro všechna čtyři pole v ovládacím prvku IP adresy.
void SetAddress(
BYTE nField0,
BYTE nField1,
BYTE nField2,
BYTE nField3);
void SetAddress(DWORD dwAddress);
Parametry
nField0
Hodnota pole 0 z zabalené IP adresy.
nField1
Hodnota pole 1 z zabalené IP adresy.
nField2
Hodnota pole 2 z zabalené IP adresy.
nField3
Hodnota pole 3 z zabalené IP adresy.
DwAddress
Hodnota DWORD, která obsahuje novou IP adresu. Viz Poznámky pro tabulku, která ukazuje, jak je hodnota DWORD vyplněna.
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_SETADDRESS, jak je popsáno v sadě Windows SDK. V prvním prototypu výše čísla v polích 0 až 3 ovládacího prvku přečtou zleva doprava a naplní čtyři parametry. V druhém prototypu výše se dwAddress vyplní následujícím způsobem.
| Pole | Bity obsahující hodnotu pole |
|---|---|
| 0 | 24 až 31 |
| 0 | 16 až 23 |
| 2 | 8 až 15 |
| 3 | 0 až 7 |
CIPAddressCtrl::SetFieldFocus
Nastaví fokus klávesnice na zadané pole v ovládacím prvku IP adresy.
void SetFieldFocus(WORD nField);
Parametry
nField
Index polí založený na nule, na který má být fokus nastaven. Pokud je tato hodnota větší než počet polí, nastaví se fokus na první prázdné pole. Pokud jsou všechna pole neprázdná, nastaví se fokus na první pole.
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_SETFOCUS, jak je popsáno v sadě Windows SDK.
CIPAddressCtrl::SetFieldRange
Nastaví rozsah v zadaném poli v ovládacím prvku IP adresy.
void SetFieldRange(
int nField,
BYTE nLower,
BYTE nUpper);
Parametry
nField
Index polí založený na nule, na který se rozsah použije.
nLower
Odkaz na celé číslo, které přijímá dolní limit zadaného pole v tomto ovládacím prvku IP adresy.
nUpper
Odkaz na celé číslo, které přijímá horní limit zadaného pole v tomto ovládacím prvku IP adresy.
Poznámky
Tato členová funkce implementuje chování zprávy Win32 IPM_SETRANGE, jak je popsáno v sadě Windows SDK. Pomocí dvou parametrů nLower a nUpper označte dolní a horní limity pole místo parametru wRange použitého se zprávou Win32.