CNetAddressCtrl 클래스
CNetAddressCtrl 클래스에 입력 한 IPv4, IPv6 및 DNS 주소를 이름이 지정된 형식의 유효성을 검사하는 데 사용할 수 있는 네트워크 주소 컨트롤을 나타냅니다.
구문
class CNetAddressCtrl : public CEdit
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | CNetAddressCtrl 개체를 생성합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CNetAddressCtrl::Create | 지정된 스타일을 사용하여 네트워크 주소 컨트롤을 만들고 현재 CNetAddressCtrl 개체에 연결합니다. |
| CNetAddressCtrl::CreateEx | 지정된 확장 스타일을 사용하여 네트워크 주소 컨트롤을 만들고 현재 CNetAddressCtrl 개체에 연결합니다. |
| CNetAddressCtrl::DisplayErrorTip | 사용자가 현재 네트워크 주소 컨트롤에서 지원되지 않는 네트워크 주소를 입력할 때 오류 풍선 팁을 표시합니다. |
| CNetAddressCtrl::GetAddress | 현재 네트워크 주소 제어와 연결된 네트워크 주소의 유효성이 검사되고 구문 분석된 표현을 검색합니다. |
| CNetAddressCtrl::GetAllowType | 현재 네트워크 주소 컨트롤에서 지원할 수 있는 네트워크 주소 유형을 검색합니다. |
| CNetAddressCtrl::SetAllowType | 현재 네트워크 주소 컨트롤에서 지원할 수 있는 네트워크 주소 유형을 설정합니다. |
설명
네트워크 주소 컨트롤은 사용자가 입력하는 주소의 형식이 올바른지 확인합니다. 컨트롤이 실제로 네트워크 주소에 연결되지 않습니다. CNetAddressCtrl::SetAllowType 메서드는 CNetAddressCtrl::GetAddress 메서드가 구문 분석하고 확인할 수 있는 하나 이상의 주소 유형을 지정합니다. 주소는 서버, 네트워크, 호스트 또는 브로드캐스트 메시지 대상에 대한 IPv4, IPv6 또는 명명된 주소 형식일 수 있습니다. 주소 형식이 잘못된 경우 CNetAddressCtrl::D isplayErrorTip 메서드를 사용하여 네트워크 주소 컨트롤의 텍스트 상자를 그래픽으로 가리키고 미리 정의된 오류 메시지를 표시하는 정보 설명 메시지 상자를 표시할 수 있습니다.
CNetAddressCtrl 클래스는 CEdit 클래스에서 파생 됩니다. 따라서 네트워크 주소 제어는 모든 Windows 편집 컨트롤 메시지에 대한 액세스를 제공합니다.
다음 그림에서는 네트워크 주소 컨트롤을 포함하는 대화 상자를 보여 줍니다. 네트워크 주소 컨트롤의 텍스트 상자(1)에 잘못된 네트워크 주소가 포함되어 있습니다. 네트워크 주소가 잘못된 경우 정보 설명 메시지(2)가 표시됩니다.
예제
다음 코드 예제는 네트워크 주소의 유효성을 검사하는 대화 상자의 일부입니다. 세 개의 라디오 단추에 대한 이벤트 처리기는 네트워크 주소가 세 가지 주소 유형 중 하나일 수 있음을 지정합니다. 사용자가 네트워크 컨트롤의 텍스트 상자에 주소를 입력한 다음 단추를 눌러 주소의 유효성을 검사합니다. 주소가 유효한 경우 성공 메시지가 표시됩니다. 그렇지 않으면 미리 정의된 infotip 오류 메시지가 표시됩니다.
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"));
}
대화 헤더 파일의 다음 코드 예제는 CNetAddressCtrl::GetAddress 메서드에 필요한 NC_ADDRESS 및 NET_ADDRESS_INFO 변수를 정의 합니다.
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
상속 계층 구조
CNetAddressCtrl
요구 사항
헤더: afxcmn.h
이 클래스는 Windows Vista 이상에서 지원됩니다.
이 클래스에 대한 추가 요구 사항은 Windows Vista 공용 컨트롤의 빌드 요구 사항에 설명 되어 있습니다.
CNetAddressCtrl::CNetAddressCtrl
CNetAddressCtrl 개체를 생성합니다.
CNetAddressCtrl();
설명
CNetAddressCtrl::Create 또는 CNetAddressCtrl::CreateEx 메서드를 사용하여 네트워크 컨트롤을 만들고 개체에 CNetAddressCtrl 연결합니다.
CNetAddressCtrl::Create
지정된 스타일을 사용하여 네트워크 주소 컨트롤을 만들고 현재 CNetAddressCtrl 개체에 연결합니다.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwStyle
[in] 컨트롤에 적용할 스타일의 비트 조합입니다. 자세한 내용은 스타일 편집을 참조 하세요.
rect
[in] 컨트롤의 위치와 크기를 포함하는 RECT 구조체에 대한 참조입니다.
pParentWnd
[in] 컨트롤의 부모 창인 CWnd 개체에 대한 null이 아닌 포인터입니다.
nID
[in] 컨트롤의 ID입니다.
Return Value
이 메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CNetAddressCtrl::CreateEx
지정된 확장 스타일을 사용하여 네트워크 주소 컨트롤을 만들고 현재 CNetAddressCtrl 개체에 연결합니다.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwExStyle
[in] 컨트롤에 적용할 확장 스타일의 비트 조합(OR)입니다. 자세한 내용은 CreateWindowEx 함수의 dwExStyle 매개 변수를 참조하세요.
dwStyle
[in] 컨트롤에 적용할 스타일의 비트 조합(OR)입니다. 자세한 내용은 스타일 편집을 참조 하세요.
rect
[in] 컨트롤의 위치와 크기를 포함하는 RECT 구조체에 대한 참조입니다.
pParentWnd
[in] 컨트롤의 부모 창인 CWnd 개체에 대한 null이 아닌 포인터입니다.
nID
[in] 컨트롤의 ID입니다.
Return Value
이 메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CNetAddressCtrl::DisplayErrorTip
현재 네트워크 주소 컨트롤과 연결된 풍선 팁에 오류 메시지를 표시합니다.
HRESULT DisplayErrorTip();
Return Value
이 메서드가 성공하면 값 S_OK 이고, 그렇지 않으면 오류 코드입니다.
설명
CNetAddressCtrl::SetAllowType 메서드를 사용하여 현재 네트워크 주소 컨트롤에서 지원할 수 있는 주소 유형을 지정합니다. CNetAddressCtrl::GetAddress 메서드를 사용하여 사용자가 입력하는 네트워크 주소의 유효성을 검사하고 구문 분석합니다. CNetAddressCtrl::GetAddress 메서드가 실패한 경우 CNetAddressCtrl::D isplayErrorTip 메서드를 사용하여 오류 메시지 정보 설명을 표시합니다.
이 메시지는 Windows SDK에 설명된 NetAddr_DisplayErrorTip 매크로를 호출합니다. 이 매크로는 NCM_DISPLAYERRORTIP 메시지를 보냅니다.
CNetAddressCtrl::GetAddress
현재 네트워크 주소 제어와 연결된 네트워크 주소의 유효성이 검사되고 구문 분석된 표현을 검색합니다.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
매개 변수
pAddress
[in, out] NC_ADDRESS 구조체에 대한 포인터입니다. GetAddress 메서드를 호출하기 전에 이 구조체의 pAddrInfo 멤버를 NET_ADDRESS_INFO 구조체의 주소로 설정합니다.
Return Value
이 메서드가 성공하면 값이 S_OK. 그렇지 않으면 COM 오류 코드입니다. 가능한 오류 코드에 대한 자세한 내용은 NetAddr_GetAddress 매크로의 반환 값 섹션을 참조하세요.
설명
이 메서드가 성공 하면 NET_ADDRESS_INFO 구조에 네트워크 주소에 대한 추가 정보가 포함됩니다.
CNetAddressCtrl::SetAllowType 메서드를 사용하여 현재 네트워크 주소 컨트롤에서 지원할 수 있는 주소 유형을 지정합니다. CNetAddressCtrl::GetAddress 메서드를 사용하여 사용자가 입력하는 네트워크 주소의 유효성을 검사하고 구문 분석합니다. CNetAddressCtrl::GetAddress 메서드가 실패한 경우 CNetAddressCtrl::D isplayErrorTip 메서드를 사용하여 오류 메시지 정보 설명을 표시합니다.
이 메서드는 Windows SDK에 설명된 NetAddr_GetAddress 매크로를 호출합니다. 이 매크로는 NCM_GETADDRESS 메시지를 보냅니다.
CNetAddressCtrl::GetAllowType
현재 네트워크 주소 컨트롤에서 지원할 수 있는 네트워크 주소 유형을 검색합니다.
DWORD GetAllowType() const;
Return Value
네트워크 주소 컨트롤에서 지원할 수 있는 주소 유형을 지정하는 플래그의 비트 조합(OR)입니다. 자세한 내용은 NET_STRING 참조하세요.
설명
이 메시지는 Windows SDK에 설명된 NetAddr_GetAllowType 매크로를 호출합니다. 이 매크로는 NCM_GETALLOWTYPE 메시지를 보냅니다.
CNetAddressCtrl::SetAllowType
현재 네트워크 주소 컨트롤에서 지원할 수 있는 네트워크 주소 유형을 설정합니다.
HRESULT SetAllowType(DWORD dwAddrMask);
매개 변수
dwAddrMask
[in] 네트워크 주소 컨트롤에서 지원할 수 있는 주소 유형을 지정하는 플래그의 비트 조합(OR)입니다. 자세한 내용은 NET_STRING 참조하세요.
Return Value
이 메서드가 성공하면 S_OK. 그렇지 않으면 COM 오류 코드입니다.
설명
CNetAddressCtrl::SetAllowType 메서드를 사용하여 현재 네트워크 주소 컨트롤에서 지원할 수 있는 주소 유형을 지정합니다. CNetAddressCtrl::GetAddress 메서드를 사용하여 사용자가 입력하는 네트워크 주소의 유효성을 검사하고 구문 분석합니다. CNetAddressCtrl::GetAddress 메서드가 실패한 경우 CNetAddressCtrl::D isplayErrorTip 메서드를 사용하여 오류 메시지 정보 설명을 표시합니다.
이 메시지는 Windows SDK에 설명된 NetAddr_SetAllowType 매크로를 호출합니다. 이 매크로는 NCM_SETALLOWTYPE 메시지를 보냅니다.
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기