Sdílet prostřednictvím


CIPAddressCtrl – třída

Poskytuje funkce běžného řízení IP adres systému Windows.

Syntaxe

class CIPAddressCtrl : public CWnd

Členové

Veřejné konstruktory

Jméno popis
CIPAddressCtrl::CIPAddressCtrl CIPAddressCtrl Vytvoří objekt.

Veřejné metody

Jméno 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

Objekt CObject

CCmdTarget

Cwnd

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.

Vrácená hodnota

Nenulové, pokud byla inicializace úspěšná; jinak 0.

Poznámky

Objekt vytvoříte CIPAddressCtrl ve dvou krocích.

  1. Volání konstruktoru, který vytvoří CIPAddressCtrl objekt.

  2. 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.

Vrácená 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.

Vrácená 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
1 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;

Vrácená 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
1 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.

Viz také

CWnd – třída
Graf hierarchie