Bagikan melalui


Kelas CIPAddressCtrl

Menyediakan fungsionalitas kontrol Alamat IP umum Windows.

Sintaks

class CIPAddressCtrl : public CWnd

Anggota

Konstruktor Publik

Nama Deskripsi
CIPAddressCtrl::CIPAddressCtrl Membuat CIPAddressCtrl objek.

Metode Publik

Nama Deskripsi
CIPAddressCtrl::ClearAddress Menghapus konten Kontrol Alamat IP.
CIPAddressCtrl::Create Membuat Kontrol Alamat IP dan melampirkannya ke CIPAddressCtrl objek.
CIPAddressCtrl::CreateEx Membuat kontrol Alamat IP dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke CIPAddressCtrl objek.
CIPAddressCtrl::GetAddress Mengambil nilai alamat untuk keempat bidang di Kontrol Alamat IP.
CIPAddressCtrl::IsBlank Menentukan apakah semua bidang dalam Kontrol Alamat IP kosong.
CIPAddressCtrl::SetAddress Mengatur nilai alamat untuk keempat bidang di Kontrol Alamat IP.
CIPAddressCtrl::SetFieldFocus Mengatur fokus keyboard ke bidang yang ditentukan di Kontrol Alamat IP.
CIPAddressCtrl::SetFieldRange Mengatur rentang di bidang yang ditentukan di Kontrol Alamat IP.

Keterangan

Kontrol Alamat IP, kontrol yang mirip dengan kontrol edit, memungkinkan Anda memasukkan dan memanipulasi alamat numerik dalam format Protokol Internet (IP).

Kontrol ini (dan oleh karena itu CIPAddressCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Microsoft Internet Explorer 4.0 dan yang lebih baru. Mereka juga akan tersedia di bawah versi Windows dan Windows NT di masa mendatang.

Untuk informasi umum selengkapnya tentang Kontrol Alamat IP, lihat Kontrol Alamat IP di Windows SDK.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Persyaratan

Header: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

CIPAddressCtrl Membuat objek.

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Menghapus konten Kontrol Alamat IP.

void ClearAddress();

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_CLEARADDRESS, seperti yang dijelaskan dalam Windows SDK.

CIPAddressCtrl::Create

Membuat Kontrol Alamat IP dan melampirkannya ke CIPAddressCtrl objek.

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

Parameter

dwStyle
Gaya kontrol Alamat IP. Terapkan kombinasi gaya jendela. Anda harus menyertakan gaya WS_CHILD karena kontrol harus merupakan jendela anak. Lihat CreateWindow di Windows SDK untuk daftar gaya windows.

rect
Referensi ke ukuran dan posisi Kontrol Alamat IP. Ini bisa berupa objek CRect atau struktur RECT .

pParentWnd
Penunjuk ke jendela induk Kontrol Alamat IP. Ini tidak boleh NULL.

Nid
ID Kontrol Alamat IP.

Tampilkan Nilai

Bukan nol jika inisialisasi berhasil; jika tidak, 0.

Keterangan

Anda membuat CIPAddressCtrl objek dalam dua langkah.

  1. Panggil konstruktor, yang membuat CIPAddressCtrl objek.

  2. Panggil Create, yang membuat Kontrol Alamat IP.

Jika Anda ingin menggunakan gaya jendela yang diperluas dengan kontrol Anda, panggil CreateEx alih-alih Create.

CIPAddressCtrl::CreateEx

Panggil fungsi ini untuk membuat kontrol (jendela anak) dan mengaitkannya dengan CIPAddressCtrl objek.

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

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat parameter dwExStyle untuk CreateWindowEx di Windows SDK.

dwStyle
Gaya kontrol Alamat IP. Terapkan kombinasi gaya jendela. Anda harus menyertakan gaya WS_CHILD karena kontrol harus merupakan jendela anak. Lihat CreateWindow di Windows SDK untuk daftar gaya windows.

rect
Referensi ke struktur RECT yang menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien pParentWnd.

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

Nid
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Gunakan CreateEx alih-alih Buat untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface gaya windows yang diperluas WS_EX_.

CIPAddressCtrl::GetAddress

Mengambil nilai alamat untuk keempat bidang di Kontrol Alamat IP.

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

int GetAddress(DWORD& dwAddress);

Parameter

nField0
Referensi ke nilai bidang 0 dari alamat IP yang dikemas.

nField1
Referensi ke nilai bidang 1 dari alamat IP yang dikemas.

nField2
Referensi ke nilai bidang 2 dari alamat IP yang dikemas.

nField3
Referensi ke nilai bidang 3 dari alamat IP yang dikemas.

dwAddress
Referensi ke alamat nilai DWORD yang menerima alamat IP. Lihat Keterangan untuk tabel yang memperlihatkan bagaimana dwAddress diisi.

Tampilkan Nilai

Jumlah bidang yang tidak kosong di Kontrol Alamat IP.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_GETADDRESS, seperti yang dijelaskan dalam Windows SDK. Pada prototipe pertama di atas, angka di bidang 0 hingga 3 kontrol, baca kiri ke kanan masing-masing, isi empat parameter. Pada prototipe kedua di atas, dwAddress diisi sebagai berikut.

Bidang Bit yang berisi nilai bidang
0 24 hingga 31
1 16 hingga 23
2 8 hingga 15
3 0 sampai 7

CIPAddressCtrl::IsBlank

Menentukan apakah semua bidang dalam Kontrol Alamat IP kosong.

BOOL IsBlank() const;

Tampilkan Nilai

Bukan nol jika semua bidang Kontrol Alamat IP kosong; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_ISBLANK, seperti yang dijelaskan di Windows SDK.

CIPAddressCtrl::SetAddress

Mengatur nilai alamat untuk keempat bidang di Kontrol Alamat IP.

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

void SetAddress(DWORD dwAddress);

Parameter

nField0
Nilai bidang 0 dari alamat IP yang dikemas.

nField1
Nilai bidang 1 dari alamat IP yang dikemas.

nField2
Nilai bidang 2 dari alamat IP yang dikemas.

nField3
Nilai bidang 3 dari alamat IP yang dikemas.

dwAddress
Nilai DWORD yang berisi alamat IP baru. Lihat Keterangan untuk tabel yang memperlihatkan bagaimana nilai DWORD diisi.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_SETADDRESS, seperti yang dijelaskan dalam Windows SDK. Pada prototipe pertama di atas, angka di bidang 0 hingga 3 kontrol, baca kiri ke kanan masing-masing, isi empat parameter. Pada prototipe kedua di atas, dwAddress diisi sebagai berikut.

Bidang Bit yang berisi nilai bidang
0 24 hingga 31
1 16 hingga 23
2 8 hingga 15
3 0 sampai 7

CIPAddressCtrl::SetFieldFocus

Mengatur fokus keyboard ke bidang yang ditentukan di Kontrol Alamat IP.

void SetFieldFocus(WORD nField);

Parameter

nField
Indeks bidang berbasis nol tempat fokus harus diatur. Jika nilai ini lebih besar dari jumlah bidang, fokus diatur ke bidang kosong pertama. Jika semua bidang tidak kosong, fokus diatur ke bidang pertama.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_SETFOCUS, seperti yang dijelaskan dalam Windows SDK.

CIPAddressCtrl::SetFieldRange

Mengatur rentang di bidang yang ditentukan di Kontrol Alamat IP.

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

Parameter

nField
Indeks bidang berbasis nol tempat rentang akan diterapkan.

nLower
Referensi ke bilangan bulat yang menerima batas bawah bidang yang ditentukan dalam Kontrol Alamat IP ini.

nUpper
Referensi ke bilangan bulat yang menerima batas atas bidang yang ditentukan dalam Kontrol Alamat IP ini.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32 IPM_SETRANGE, seperti yang dijelaskan dalam Windows SDK. Gunakan dua parameter, nLower dan nUpper, untuk menunjukkan batas bawah dan atas bidang, alih-alih parameter wRange yang digunakan dengan pesan Win32.

Lihat juga

Kelas CWnd
Bagan Hierarki