Kelas CNetAddressCtrl

Kelas mewakili CNetAddressCtrl kontrol alamat jaringan, yang dapat Anda gunakan untuk memasukkan dan memvalidasi format IPv4, IPv6, dan alamat DNS bernama.

Sintaks

class CNetAddressCtrl : public CEdit

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Kontrol alamat jaringan memverifikasi bahwa format alamat yang dimasukkan pengguna sudah benar. Kontrol tidak benar-benar tersambung ke alamat jaringan. Metode CNetAddressCtrl::SetAllowType menentukan satu atau beberapa jenis alamat yang dapat diurai dan diverifikasi oleh metode CNetAddressCtrl::GetAddress . Alamat dapat dalam bentuk IPv4, IPv6, atau alamat bernama untuk server, jaringan, host, atau tujuan pesan siaran. Jika format alamat salah, Anda bisa menggunakan metode CNetAddressCtrl::D isplayErrorTip untuk menampilkan kotak pesan infotip yang secara grafis menunjuk ke kotak teks kontrol alamat jaringan dan menampilkan pesan kesalahan yang telah ditentukan sebelumnya.

Kelas CNetAddressCtrl ini berasal dari kelas CEdit . Akibatnya, kontrol alamat jaringan menyediakan akses ke semua pesan kontrol pengeditan Windows.

Gambar berikut menggambarkan dialog yang berisi kontrol alamat jaringan. Kotak teks (1) untuk kontrol alamat jaringan berisi alamat jaringan yang tidak valid. Pesan infotip (2) ditampilkan jika alamat jaringan tidak valid.

Contoh

Contoh kode berikut adalah bagian dari dialog yang memvalidasi alamat jaringan. Penanganan aktivitas untuk tiga tombol radio menentukan bahwa alamat jaringan dapat menjadi salah satu dari tiga jenis alamat. Pengguna memasukkan alamat dalam kotak teks kontrol jaringan, lalu menekan tombol untuk memvalidasi alamat. Jika alamat valid, pesan keberhasilan ditampilkan; jika tidak, pesan kesalahan infotip yang telah ditentukan sebelumnya ditampilkan.

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio1()
{
   m_netAddr.SetAllowType(NET_STRING_IPV4_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio2()
{
   m_netAddr.SetAllowType(NET_STRING_IPV6_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio3()
{
   m_netAddr.SetAllowType(NET_STRING_NAMED_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedButton1()
{
   m_na.pAddrInfo = &m_nai;
   HRESULT rslt = m_netAddr.GetAddress(&m_na);
   if (rslt != S_OK)
      m_netAddr.DisplayErrorTip();
   else
   {
      MessageBox(
          _T("Success!"), _T("Validation Results"));
   }

Contoh kode berikut dari file header dialog menentukan variabel NC_ADDRESS dan NET_ADDRESS_INFO yang diperlukan oleh metode CNetAddressCtrl::GetAddress .

NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;

Hierarki Warisan

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

Persyaratan

Header: afxcmn.h

Kelas ini didukung di Windows Vista dan yang lebih baru.

Persyaratan tambahan untuk kelas ini dijelaskan dalam Persyaratan Build untuk Kontrol Umum Windows Vista.

CNetAddressCtrl::CNetAddressCtrl

Membuat CNetAddressCtrl objek.

CNetAddressCtrl();

Keterangan

Gunakan metode CNetAddressCtrl::Create atau CNetAddressCtrl::CreateEx untuk membuat kontrol jaringan dan melampirkannya ke CNetAddressCtrl objek.

CNetAddressCtrl::Create

Membuat kontrol alamat jaringan dengan gaya tertentu dan melampirkannya ke objek saat ini CNetAddressCtrl .

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

Parameter

dwStyle
[di] Kombinasi gaya bitwise yang akan diterapkan ke kontrol. Untuk informasi selengkapnya, lihat Edit Gaya.

rect
[di] Referensi ke struktur RECT yang berisi posisi dan ukuran kontrol.

pParentWnd
[di] Penunjuk non-null ke objek CWnd yang merupakan jendela induk kontrol.

Nid
[di] ID kontrol.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

CNetAddressCtrl::CreateEx

Membuat kontrol alamat jaringan dengan gaya yang diperluas yang ditentukan dan melampirkannya ke objek saat ini CNetAddressCtrl .

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

Parameter

dwExStyle
[di] Kombinasi bitwise (OR) dari gaya yang diperluas untuk diterapkan ke kontrol. Untuk informasi selengkapnya, lihat parameter dwExStyle dari fungsi CreateWindowEx .

dwStyle
[di] Kombinasi bitwise (OR) gaya yang akan diterapkan ke kontrol. Untuk informasi selengkapnya, lihat Edit Gaya.

rect
[di] Referensi ke struktur RECT yang berisi posisi dan ukuran kontrol.

pParentWnd
[di] Penunjuk non-null ke objek CWnd yang merupakan jendela induk kontrol.

Nid
[di] ID kontrol.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

CNetAddressCtrl::D isplayErrorTip

Menampilkan pesan kesalahan dalam tip balon yang terkait dengan kontrol alamat jaringan saat ini.

HRESULT DisplayErrorTip();

Tampilkan Nilai

Nilai S_OK jika metode ini berhasil; jika tidak, kode kesalahan.

Keterangan

Gunakan metode CNetAddressCtrl::SetAllowType untuk menentukan jenis alamat yang dapat didukung kontrol alamat jaringan saat ini. Gunakan metode CNetAddressCtrl::GetAddress untuk memvalidasi dan mengurai alamat jaringan yang dimasukkan pengguna. Gunakan metode CNetAddressCtrl::D isplayErrorTip untuk menampilkan infotip pesan kesalahan jika metode CNetAddressCtrl::GetAddress tidak berhasil.

Pesan ini memanggil makro NetAddr_DisplayErrorTip , yang dijelaskan dalam Windows SDK. Makro itu mengirim NCM_DISPLAYERRORTIP pesan.

CNetAddressCtrl::GetAddress

Mengambil representasi alamat jaringan yang divalidasi dan diurai yang terkait dengan kontrol alamat jaringan saat ini.

HRESULT GetAddress(PNC_ADDRESS pAddress) const;

Parameter

pAddress
[masuk, keluar] Penunjuk ke struktur NC_ADDRESS . Atur anggota pAddrInfo dari struktur ini ke alamat struktur NET_ADDRESS_INFO sebelum Anda memanggil metode GetAddress.

Tampilkan Nilai

Nilai S_OK jika metode ini berhasil; jika tidak, kode kesalahan COM. Untuk informasi selengkapnya tentang kemungkinan kode kesalahan, lihat bagian Nilai Pengembalian dari makro NetAddr_GetAddress .

Keterangan

Jika metode ini berhasil, struktur NET_ADDRESS_INFO berisi informasi tambahan tentang alamat jaringan.

Gunakan metode CNetAddressCtrl::SetAllowType untuk menentukan jenis alamat yang dapat didukung kontrol alamat jaringan saat ini. Gunakan metode CNetAddressCtrl::GetAddress untuk memvalidasi dan mengurai alamat jaringan yang dimasukkan pengguna. Gunakan metode CNetAddressCtrl::D isplayErrorTip untuk menampilkan infotip pesan kesalahan jika metode CNetAddressCtrl::GetAddress tidak berhasil.

Metode ini memanggil makro NetAddr_GetAddress , yang dijelaskan dalam Windows SDK. Makro tersebut mengirim pesan NCM_GETADDRESS.

CNetAddressCtrl::GetAllowType

Mengambil jenis alamat jaringan yang dapat didukung oleh kontrol alamat jaringan saat ini.

DWORD GetAllowType() const;

Tampilkan Nilai

Kombinasi bitwise (OR) bendera yang menentukan jenis alamat yang dapat didukung kontrol alamat jaringan. Untuk informasi selengkapnya, lihat NET_STRING.

Keterangan

Pesan ini memanggil makro NetAddr_GetAllowType , yang dijelaskan dalam Windows SDK. Makro tersebut mengirim pesan NCM_GETALLOWTYPE.

CNetAddressCtrl::SetAllowType

Menyetel tipe alamat jaringan yang dapat didukung oleh kontrol alamat jaringan saat ini.

HRESULT SetAllowType(DWORD dwAddrMask);

Parameter

dwAddrMask
[di] Kombinasi bitwise (OR) bendera yang menentukan jenis alamat yang dapat didukung kontrol alamat jaringan. Untuk informasi selengkapnya, lihat NET_STRING.

Tampilkan Nilai

S_OK jika metode ini berhasil; jika tidak, kode kesalahan COM.

Keterangan

Gunakan metode CNetAddressCtrl::SetAllowType untuk menentukan jenis alamat yang dapat didukung kontrol alamat jaringan saat ini. Gunakan metode CNetAddressCtrl::GetAddress untuk memvalidasi dan mengurai alamat jaringan yang dimasukkan pengguna. Gunakan metode CNetAddressCtrl::D isplayErrorTip untuk menampilkan infotip pesan kesalahan jika metode CNetAddressCtrl::GetAddress tidak berhasil.

Pesan ini memanggil makro NetAddr_SetAllowType , yang dijelaskan di Windows SDK. Makro tersebut mengirim pesan NCM_SETALLOWTYPE.

Lihat juga

Kelas CNetAddressCtrl
Bagan Hierarki
Kelas CEdit