CNetAddressCtrl Sınıfı
CNetAddressCtrl sınıfı, IPv4, IPv6 ve adlandırılmış DNS adreslerinin biçimini girip doğrulamak için kullanabileceğiniz ağ adresi denetimini temsil eder.
Sözdizimi
class CNetAddressCtrl : public CEdit
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | Bir CNetAddressCtrl nesne oluşturur. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CNetAddressCtrl::Create | Belirtilen stiller ile bir ağ adresi denetimi oluşturur ve bunu geçerli CNetAddressCtrl nesneye ekler. |
| CNetAddressCtrl::CreateEx | Belirtilen genişletilmiş stillerle bir ağ adresi denetimi oluşturur ve bunu geçerli CNetAddressCtrl nesneye ekler. |
| CNetAddressCtrl::D isplayErrortip | Kullanıcı geçerli ağ adresi denetimine desteklenmeyen bir ağ adresi girdiğinde bir hata balonu ipucu görüntüler. |
| CNetAddressCtrl::GetAddress | Geçerli ağ adresi denetimiyle ilişkili ağ adresinin doğrulanmış ve ayrıştırılmış bir gösterimini alır. |
| CNetAddressCtrl::GetAllowType | Geçerli ağ adresi denetiminin destekleyebilecek ağ adresi türünü alır. |
| CNetAddressCtrl::SetAllowType | Geçerli ağ adresi denetiminin destekleyebilecek ağ adresi türünü ayarlar. |
Açıklamalar
Ağ adresi denetimi, kullanıcının girdiği adresin biçiminin doğru olduğunu doğrular. Denetim aslında ağ adresine bağlanmaz. CNetAddressCtrl::SetAllowType yöntemi, CNetAddressCtrl::GetAddress yönteminin ayrıştırabileceği ve doğrulayabildiği bir veya daha fazla adres türünü belirtir. Adres, bir sunucu, ağ, konak veya yayın iletisi hedefi için IPv4, IPv6 veya adlandırılmış adres biçiminde olabilir. Adresin biçimi yanlışsa CNetAddressCtrl::D isplayErrorTip yöntemini kullanarak ağ adresi denetiminin metin kutusuna grafik olarak işaret eden ve önceden tanımlanmış bir hata iletisi görüntüleyen bir bilgi ipucu ileti kutusu görüntüleyebilirsiniz.
CNetAddressCtrl sınıfı CEdit sınıfından türetilir. Sonuç olarak, ağ adresi denetimi tüm Windows düzenleme denetimi iletilerine erişim sağlar.
Aşağıdaki şekilde ağ adresi denetimi içeren bir iletişim kutusu gösterilmektedir. Ağ adresi denetiminin metin kutusu (1) geçersiz bir ağ adresi içeriyor. Ağ adresi geçersizse bilgi ipucu iletisi (2) görüntülenir.
Örnekler
Aşağıdaki kod örneği, iletişim kutusunun ağ adresini doğrulayan bir bölümüdür. Üç radyo düğmesinin olay işleyicileri, ağ adresinin üç adres türünden biri olabileceğini belirtir. Kullanıcı ağ denetiminin metin kutusuna bir adres girer ve ardından adresi doğrulamak için bir düğmeye basar. Adres geçerliyse, bir başarı iletisi görüntülenir; aksi takdirde, önceden tanımlanmış bilgi ipucu hata iletisi görüntülenir.
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"));
}
İletişim kutusu üst bilgi dosyasındaki aşağıdaki kod örneği, CNetAddressCtrl::GetAddress yönteminin gerektirdiği NC_ADDRESS ve NET_ADDRESS_INFO değişkenlerini tanımlar.
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
Devralma Hiyerarşisi
CNetAddressCtrl
Gereksinimler
Üst bilgi: afxcmn.h
Bu sınıf Windows Vista ve sonraki sürümlerde desteklenir.
Bu sınıf için ek gereksinimler, Windows Vista Ortak Denetimleri için Derleme Gereksinimleri bölümünde açıklanmıştır.
CNetAddressCtrl::CNetAddressCtrl
Bir CNetAddressCtrl nesne oluşturur.
CNetAddressCtrl();
Açıklamalar
Ağ denetimi oluşturmak ve bunu nesneye eklemek CNetAddressCtrl için CNetAddressCtrl::Create veya CNetAddressCtrl::CreateEx yöntemini kullanın.
CNetAddressCtrl::Create
Belirtilen stiller ile bir ağ adresi denetimi oluşturur ve bunu geçerli CNetAddressCtrl nesneye ekler.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametreler
dwStyle
[in] Denetime uygulanacak stillerin bit düzeyinde birleşimi. Daha fazla bilgi için bkz . Stilleri Düzenleme.
Rect
[in] Denetimin konumunu ve boyutunu içeren rect yapısına başvuru.
pParentWnd
[in] Denetimin üst penceresi olan bir CWnd nesnesinin null olmayan işaretçisi.
Nıd
[in] Denetimin kimliği.
Dönüş Değeri
Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
CNetAddressCtrl::CreateEx
Belirtilen genişletilmiş stillerle bir ağ adresi denetimi oluşturur ve bunu geçerli CNetAddressCtrl nesneye ekler.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametreler
dwExStyle
[in] Denetime uygulanacak genişletilmiş stillerin bit düzeyinde birleşimi (VEYA). Daha fazla bilgi için CreateWindowEx işlevinin dwExStyle parametresine bakın.
dwStyle
[in] Denetime uygulanacak stillerden oluşan bit düzeyinde bir birleşim (OR). Daha fazla bilgi için bkz . Stilleri Düzenleme.
Rect
[in] Denetimin konumunu ve boyutunu içeren rect yapısına başvuru.
pParentWnd
[in] Denetimin üst penceresi olan bir CWnd nesnesinin null olmayan işaretçisi.
Nıd
[in] Denetimin kimliği.
Dönüş Değeri
Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
CNetAddressCtrl::D isplayErrortip
Balon ipucunda geçerli ağ adresi denetimiyle ilişkili bir hata iletisi görüntüler.
HRESULT DisplayErrorTip();
Dönüş Değeri
Bu yöntem başarılı olursa değer S_OK ; aksi takdirde bir hata kodu.
Açıklamalar
Geçerli ağ adresi denetiminin destekleyebilecek adres türlerini belirtmek için CNetAddressCtrl::SetAllowType yöntemini kullanın. Kullanıcının girdiği ağ adresini doğrulamak ve ayrıştırmak için CNetAddressCtrl::GetAddress yöntemini kullanın. CNetAddressCtrl::GetAddress yöntemi başarısız olursa bir hata iletisi bilgi ipucu görüntülemek için CNetAddressCtrl::D isplayErrorTip yöntemini kullanın.
Bu ileti, Windows SDK'sında açıklanan NetAddr_DisplayErrorTip makroyu çağırır. Bu makro iletiyi gönderir NCM_DISPLAYERRORTIP .
CNetAddressCtrl::GetAddress
Geçerli ağ adresi denetimiyle ilişkili ağ adresinin doğrulanmış ve ayrıştırılmış bir gösterimini alır.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
Parametreler
pAddress
[in, out] bir NC_ADDRESS yapısının işaretçisi. GetAddress yöntemini çağırmadan önce bu yapının pAddrInfo üyesini bir NET_ADDRESS_INFO yapısının adresi olarak ayarlayın.
Dönüş Değeri
Bu yöntem başarılı olursa değer S_OK; aksi takdirde, bir COM hata kodu. Olası hata kodları hakkında daha fazla bilgi için NetAddr_GetAddress makrosunun Dönüş Değeri bölümüne bakın.
Açıklamalar
Bu yöntem başarılı olursa, NET_ADDRESS_INFO yapısı ağ adresi hakkında ek bilgiler içerir.
Geçerli ağ adresi denetiminin destekleyebileceğiniz adres türlerini belirtmek için CNetAddressCtrl::SetAllowType yöntemini kullanın. Kullanıcının girdiği ağ adresini doğrulamak ve ayrıştırmak için CNetAddressCtrl::GetAddress yöntemini kullanın. CNetAddressCtrl::GetAddress yöntemi başarısız olursa bir hata iletisi bilgi ipucu görüntülemek için CNetAddressCtrl::D isplayErrorTip yöntemini kullanın.
Bu yöntem, Windows SDK'sında açıklanan NetAddr_GetAddress makroyu çağırır. Bu makro NCM_GETADDRESS iletisini gönderir.
CNetAddressCtrl::GetAllowType
Geçerli ağ adresi denetiminin destekleyebilecek ağ adresi türünü alır.
DWORD GetAllowType() const;
Dönüş Değeri
Ağ adresi denetiminin destekleyebilecek adres türlerini belirten bit düzeyinde bir bayrak bileşimi (OR). Daha fazla bilgi için bkz . NET_STRING.
Açıklamalar
Bu ileti, Windows SDK'sında açıklanan NetAddr_GetAllowType makroyu çağırır. Bu makro NCM_GETALLOWTYPE iletisini gönderir.
CNetAddressCtrl::SetAllowType
Geçerli ağ adresi denetiminin destekleyebilecek ağ adresi türünü ayarlar.
HRESULT SetAllowType(DWORD dwAddrMask);
Parametreler
dwAddrMask
[in] Ağ adresi denetiminin destekleyebilecek adres türlerini belirten bit düzeyinde bir bayrak bileşimi (OR). Daha fazla bilgi için bkz . NET_STRING.
Dönüş Değeri
Bu yöntemin başarılı olup olmadığını S_OK; aksi takdirde, bir COM hata kodu.
Açıklamalar
Geçerli ağ adresi denetiminin destekleyebilecek adres türlerini belirtmek için CNetAddressCtrl::SetAllowType yöntemini kullanın. Kullanıcının girdiği ağ adresini doğrulamak ve ayrıştırmak için CNetAddressCtrl::GetAddress yöntemini kullanın. CNetAddressCtrl::GetAddress yöntemi başarısız olursa bir hata iletisi bilgi ipucu görüntülemek için CNetAddressCtrl::D isplayErrorTip yöntemini kullanın.
Bu ileti, Windows SDK'sında açıklanan NetAddr_SetAllowType makroyu çağırır. Bu makro NCM_SETALLOWTYPE iletisini gönderir.