Udostępnij za pośrednictwem

Klasa CIPAddressCtrl

  • Artykuł

Zapewnia funkcjonalność wspólnej kontrolki adresów IP systemu Windows.

Składnia

class CIPAddressCtrl : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CIPAddressCtrl::CIPAddressCtrl CIPAddressCtrl Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CIPAddressCtrl::ClearAddress Czyści zawartość kontrolki adresów IP.
CIPAddressCtrl::Create Tworzy kontrolkę adresu IP i dołącza ją do CIPAddressCtrl obiektu.
CIPAddressCtrl::CreateEx Tworzy kontrolkę Adres IP z określonymi stylami rozszerzonymi systemu Windows i dołącza ją do CIPAddressCtrl obiektu.
CIPAddressCtrl::GetAddress Pobiera wartości adresów dla wszystkich czterech pól w kontrolce adresów IP.
CIPAddressCtrl::IsBlank Określa, czy wszystkie pola w kontrolce adresów IP są puste.
CIPAddressCtrl::SetAddress Ustawia wartości adresów dla wszystkich czterech pól w kontrolce adresów IP.
CIPAddressCtrl::SetFieldFocus Ustawia fokus klawiatury na określone pole w kontrolce adresów IP.
CIPAddressCtrl::SetFieldRange Ustawia zakres w określonym polu w kontrolce adresów IP.

Uwagi

Kontrolka Adres IP, kontrolka podobna do kontrolki edycji, umożliwia wprowadzanie i manipulowanie adresem liczbowym w formacie protokołu internetowego (IP).

Ta kontrolka CIPAddressCtrl (i dlatego klasa) jest dostępna tylko dla programów działających w programie Microsoft Internet Explorer 4.0 lub nowszym. Będą one również dostępne w przyszłych wersjach systemów Windows i Windows NT.

Aby uzyskać więcej ogólnych informacji na temat kontrolki adresów IP, zobacz Kontrolki adresów IP w zestawie Windows SDK.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CIPAddressCtrl

Wymagania

Nagłówek: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

Tworzy obiekt CIPAddressCtrl.

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Czyści zawartość kontrolki adresów IP.

void ClearAddress();

Uwagi

Ta funkcja składowa implementuje zachowanie IPM_CLEARADDRESS komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

CIPAddressCtrl::Create

Tworzy kontrolkę adresu IP i dołącza ją do CIPAddressCtrl obiektu.

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

Parametry

dwStyle
Styl kontrolki Adres IP. Zastosuj kombinację stylów okien. Musisz uwzględnić styl WS_CHILD, ponieważ kontrolka musi być oknem podrzędnym. Aby uzyskać listę stylów systemu Windows, zobacz CreateWindow in the Windows SDK (Tworzenie systemu Windows w zestawie SDK systemu Windows).

Rect
Odwołanie do rozmiaru i położenia kontrolki adresu IP. Może to być obiekt CRect lub struktura RECT .

pParentWnd
Wskaźnik do okna nadrzędnego kontrolki adresu IP. Nie może mieć wartości NULL.

Nid
Identyfikator kontrolki adresu IP.

Wartość zwracana

Niezerowe, jeśli inicjowanie zakończyło się pomyślnie; w przeciwnym razie 0.

Uwagi

Obiekt jest konstruowany CIPAddressCtrl w dwóch krokach.

  1. Wywołaj konstruktor, który tworzy CIPAddressCtrl obiekt.

  2. Wywołaj metodę Create, która tworzy kontrolkę adresu IP.

Jeśli chcesz użyć rozszerzonych stylów okien z kontrolką, wywołaj metodę CreateEx zamiast Create.

CIPAddressCtrl::CreateEx

Wywołaj tę funkcję, aby utworzyć kontrolkę (okno podrzędne) i skojarz ją z obiektem CIPAddressCtrl .

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

Parametry

dwExStyle
Określa rozszerzony styl tworzonej kontrolki. Aby uzyskać listę rozszerzonych stylów systemu Windows, zobacz parametr dwExStyle dla polecenia CreateWindowEx w zestawie WINDOWS SDK.

dwStyle
Styl kontrolki Adres IP. Zastosuj kombinację stylów okien. Musisz uwzględnić styl WS_CHILD, ponieważ kontrolka musi być oknem podrzędnym. Aby uzyskać listę stylów systemu Windows, zobacz CreateWindow in the Windows SDK (Tworzenie systemu Windows w zestawie SDK systemu Windows).

Rect
Odwołanie do struktury RECT opisującej rozmiar i położenie okna do utworzenia w współrzędnych klienta pParentWnd.

pParentWnd
Wskaźnik do okna, który jest elementem nadrzędnym kontrolki.

Nid
Identyfikator okna podrzędnego kontrolki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Użyj CreateEx zamiast opcji Utwórz, aby zastosować rozszerzone style systemu Windows określone przez WS_EX_ stylu rozszerzonego systemu Windows.

CIPAddressCtrl::GetAddress

Pobiera wartości adresów dla wszystkich czterech pól w kontrolce adresów IP.

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

int GetAddress(DWORD& dwAddress);

Parametry

nField0
Odwołanie do wartości pola 0 z zapakowanego adresu IP.

nField1
Odwołanie do wartości pola 1 z zapakowanego adresu IP.

nField2
Odwołanie do wartości pola 2 z spakowanego adresu IP.

nField3
Odwołanie do wartości pola 3 z spakowanego adresu IP.

dwAddress
Odwołanie do adresu wartości DWORD, która odbiera adres IP. Zobacz Uwagi dotyczące tabeli, w których pokazano, jak wypełniana jest wartość dwAddress .

Wartość zwracana

Liczba pól innych niż puste w kontrolce adresów IP.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu Win32 IPM_GETADDRESS zgodnie z opisem w zestawie WINDOWS SDK. W pierwszym prototypie powyżej liczby w polach od 0 do 3 kontrolki odczytane są odpowiednio od lewej do prawej, wypełniają cztery parametry. W drugim prototypie powyżej dwAddress jest wypełniany w następujący sposób.

Pole Bity zawierające wartość pola
0 Od 24 do 31
1 Od 16 do 23
2 Od 8 do 15
3 Od 0 do 7

CIPAddressCtrl::IsBlank

Określa, czy wszystkie pola w kontrolce adresów IP są puste.

BOOL IsBlank() const;

Wartość zwracana

Niezerowe, jeśli wszystkie pola kontrolki adresów IP są puste; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa implementuje zachowanie IPM_ISBLANK komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

CIPAddressCtrl::SetAddress

Ustawia wartości adresów dla wszystkich czterech pól w kontrolce adresów IP.

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

void SetAddress(DWORD dwAddress);

Parametry

nField0
Wartość pola 0 z zapakowanego adresu IP.

nField1
Wartość pola 1 z spakowanego adresu IP.

nField2
Wartość pola 2 z spakowanego adresu IP.

nField3
Wartość pola 3 z spakowanego adresu IP.

dwAddress
Wartość DWORD zawierająca nowy adres IP. Zobacz Uwagi dotyczące tabeli, która pokazuje, jak wypełniana jest wartość DWORD.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu Win32 IPM_SETADDRESS zgodnie z opisem w zestawie Windows SDK. W pierwszym prototypie powyżej liczby w polach od 0 do 3 kontrolki odczytane są odpowiednio od lewej do prawej, wypełniają cztery parametry. W drugim prototypie powyżej dwAddress jest wypełniany w następujący sposób.

Pole Bity zawierające wartość pola
0 Od 24 do 31
1 Od 16 do 23
2 Od 8 do 15
3 Od 0 do 7

CIPAddressCtrl::SetFieldFocus

Ustawia fokus klawiatury na określone pole w kontrolce adresów IP.

void SetFieldFocus(WORD nField);

Parametry

nPole
Indeks pól oparty na zera, do którego należy ustawić fokus. Jeśli ta wartość jest większa niż liczba pól, fokus jest ustawiony na pierwsze puste pole. Jeśli wszystkie pola nie są puste, fokus jest ustawiony na pierwsze pole.

Uwagi

Ta funkcja składowa implementuje zachowanie IPM_SETFOCUS komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

CIPAddressCtrl::SetFieldRange

Ustawia zakres w określonym polu w kontrolce adresów IP.

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

Parametry

nPole
Indeks pól oparty na zera, do którego zostanie zastosowany zakres.

nLower
Odwołanie do liczby całkowitej odbierające dolną granicę określonego pola w tej kontrolce adresów IP.

nUpper
Odwołanie do liczby całkowitej odbierające górny limit określonego pola w tej kontrolce adresów IP.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu Win32 IPM_SETRANGE zgodnie z opisem w zestawie WINDOWS SDK. Użyj dwóch parametrów, nLower i nUpper, aby wskazać dolne i górne limity pola, zamiast parametru wRange używanego z komunikatem Win32.

Zobacz też

Klasa CWnd
Wykres hierarchii