CIPAddressCtrl 클래스
Windows의 공용 IP 주소 컨트롤의 기능을 제공합니다.
구문
class CIPAddressCtrl : public CWnd
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | CIPAddressCtrl 개체를 생성합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CIPAddressCtrl::ClearAddress | IP 주소 컨트롤의 내용을 지웁니다. |
| CIPAddressCtrl::Create | IP 주소 컨트롤을 만들어 개체에 CIPAddressCtrl 연결합니다. |
| CIPAddressCtrl::CreateEx | 지정된 Windows 확장 스타일을 사용하여 IP 주소 컨트롤을 만들고 개체에 CIPAddressCtrl 연결합니다. |
| CIPAddressCtrl::GetAddress | IP 주소 컨트롤의 네 필드 모두에 대한 주소 값을 검색합니다. |
| CIPAddressCtrl::IsBlank | IP 주소 컨트롤의 모든 필드가 비어 있는지 여부를 확인합니다. |
| CIPAddressCtrl::SetAddress | IP 주소 컨트롤의 네 필드 모두에 대한 주소 값을 설정합니다. |
| CIPAddressCtrl::SetFieldFocus | 키보드 포커스를 IP 주소 컨트롤의 지정된 필드로 설정합니다. |
| CIPAddressCtrl::SetFieldRange | IP 주소 컨트롤에서 지정된 필드의 범위를 설정합니다. |
설명
편집 컨트롤과 유사한 컨트롤인 IP 주소 컨트롤을 사용하면 IP(인터넷 프로토콜) 형식으로 숫자 주소를 입력하고 조작할 수 있습니다.
이 컨트롤(따라서 CIPAddressCtrl 클래스)은 Microsoft Internet Explorer 4.0 이상에서 실행되는 프로그램에서만 사용할 수 있습니다. 이후 버전의 Windows 및 Windows NT에서도 사용할 수 있습니다.
IP 주소 컨트롤에 대한 자세한 내용은 Windows SDK의 IP 주소 컨트롤을 참조하세요.
상속 계층 구조
CIPAddressCtrl
요구 사항
헤더: afxcmn.h
CIPAddressCtrl::CIPAddressCtrl
CIPAddressCtrl 개체를 만듭니다.
CIPAddressCtrl();
CIPAddressCtrl::ClearAddress
IP 주소 컨트롤의 내용을 지웁니다.
void ClearAddress();
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_CLEARADDRESS 동작을 구현합니다.
CIPAddressCtrl::Create
IP 주소 컨트롤을 만들어 개체에 CIPAddressCtrl 연결합니다.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwStyle
IP 주소 컨트롤의 스타일입니다. 창 스타일의 조합을 적용합니다. 컨트롤이 자식 창이어야 하므로 WS_CHILD 스타일을 포함해야 합니다. Windows 스타일 목록은 Windows SDK의 CreateWindow를 참조하세요.
rect
IP 주소 컨트롤의 크기와 위치에 대한 참조입니다. CRect 개체 또는 RECT 구조체일 수 있습니다.
pParentWnd
IP 주소 컨트롤의 부모 창에 대한 포인터입니다. NULL이 아니어야 합니다.
nID
IP 주소 컨트롤의 ID입니다.
Return Value
초기화에 성공하면 0이 아닌 값입니다. 그렇지 않으면 0입니다.
설명
두 단계로 개체를 CIPAddressCtrl 생성합니다.
개체를 만드는 생성자를 호출합니다
CIPAddressCtrl.호출
Create- IP 주소 컨트롤을 만듭니다.
컨트롤에 확장 창 스타일을 사용하려면 대신 CreateExCreate를 호출합니다.
CIPAddressCtrl::CreateEx
이 함수를 호출하여 컨트롤(자식 창)을 만들고 개체와 CIPAddressCtrl 연결합니다.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwExStyle
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 CreateWindowEx에 대한 dwExStyle 매개 변수를 참조하세요.
dwStyle
IP 주소 컨트롤의 스타일입니다. 창 스타일의 조합을 적용합니다. 컨트롤이 자식 창이어야 하므로 WS_CHILD 스타일을 포함해야 합니다. Windows 스타일 목록은 Windows SDK의 CreateWindow를 참조하세요.
rect
pParentWnd의 클라이언트 좌표에서 만들 창의 크기와 위치를 설명하는 RECT 구조체에 대한 참조입니다.
pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.
nID
컨트롤의 자식 창 ID입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
Windows 확장 스타일 서문 WS_EX_ 지정된 확장 Windows 스타일을 적용하려면 만들기 대신 사용합니다CreateEx.
CIPAddressCtrl::GetAddress
IP 주소 컨트롤의 네 필드 모두에 대한 주소 값을 검색합니다.
int GetAddress(
BYTE& nField0,
BYTE& nField1,
BYTE& nField2,
BYTE& nField3);
int GetAddress(DWORD& dwAddress);
매개 변수
nField0
압축된 IP 주소에서 필드 0 값에 대한 참조입니다.
nField1
압축된 IP 주소의 필드 1 값에 대한 참조입니다.
nField2
압축된 IP 주소의 필드 2 값에 대한 참조입니다.
nField3
압축된 IP 주소의 필드 3 값에 대한 참조입니다.
dwAddress
IP 주소를 받는 DWORD 값의 주소에 대한 참조입니다. dwAddress가 채워지는 방법을 보여 주는 표에 대해서는 비고를 참조하세요.
Return Value
IP 주소 컨트롤의 비어 있는 필드가 아닌 필드의 수입니다.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_GETADDRESS 동작을 구현합니다. 위의 첫 번째 프로토타입에서 컨트롤의 필드 0에서 3까지의 숫자는 각각 왼쪽에서 오른쪽으로 읽고 네 개의 매개 변수를 채웁니다. 위의 두 번째 프로토타입에서 dwAddress 는 다음과 같이 채워집니다.
| 필드 | 필드 값이 포함된 비트 |
|---|---|
| 0 | 24~31 |
| 1 | 16~23 |
| 2 | 8~15 |
| 3 | 0~7 |
CIPAddressCtrl::IsBlank
IP 주소 컨트롤의 모든 필드가 비어 있는지 여부를 확인합니다.
BOOL IsBlank() const;
Return Value
모든 IP 주소 제어 필드가 비어 있으면 0이 아닌 경우 그렇지 않으면 0입니다.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_ISBLANK 동작을 구현합니다.
CIPAddressCtrl::SetAddress
IP 주소 컨트롤의 네 필드 모두에 대한 주소 값을 설정합니다.
void SetAddress(
BYTE nField0,
BYTE nField1,
BYTE nField2,
BYTE nField3);
void SetAddress(DWORD dwAddress);
매개 변수
nField0
압축된 IP 주소의 필드 0 값입니다.
nField1
압축된 IP 주소의 필드 1 값입니다.
nField2
압축된 IP 주소의 필드 2 값입니다.
nField3
압축된 IP 주소의 필드 3 값입니다.
dwAddress
새 IP 주소를 포함하는 DWORD 값입니다. DWORD 값이 채워지는 방법을 보여 주는 표의 설명은 참조하세요.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_SETADDRESS 동작을 구현합니다. 위의 첫 번째 프로토타입에서 컨트롤의 필드 0에서 3까지의 숫자는 각각 왼쪽에서 오른쪽으로 읽고 네 개의 매개 변수를 채웁니다. 위의 두 번째 프로토타입에서 dwAddress 는 다음과 같이 채워집니다.
| 필드 | 필드 값이 포함된 비트 |
|---|---|
| 0 | 24~31 |
| 1 | 16~23 |
| 2 | 8~15 |
| 3 | 0~7 |
CIPAddressCtrl::SetFieldFocus
키보드 포커스를 IP 주소 컨트롤의 지정된 필드로 설정합니다.
void SetFieldFocus(WORD nField);
매개 변수
nField
포커스를 설정해야 하는 필드 인덱스(0부터 시작)입니다. 이 값이 필드 수보다 크면 포커스가 첫 번째 빈 필드로 설정됩니다. 모든 필드가 비어있지 않으면 포커스가 첫 번째 필드로 설정됩니다.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_SETFOCUS 동작을 구현합니다.
CIPAddressCtrl::SetFieldRange
IP 주소 컨트롤에서 지정된 필드의 범위를 설정합니다.
void SetFieldRange(
int nField,
BYTE nLower,
BYTE nUpper);
매개 변수
nField
범위를 적용할 필드 인덱스(0부터 시작)입니다.
nLower
이 IP 주소 컨트롤에서 지정된 필드의 하한을 받는 정수에 대한 참조입니다.
nUpper
이 IP 주소 컨트롤에서 지정된 필드의 상한을 수신하는 정수에 대한 참조입니다.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 IPM_SETRANGE 동작을 구현합니다. Win32 메시지와 함께 사용되는 wRange 매개 변수 대신 두 매개 변수인 nLower 및 nUpper를 사용하여 필드의 하한 및 상한을 나타냅니다.