GetDlgItemInt 함수(winuser.h)

아티클
03/13/2024

대화 상자에서 지정된 컨트롤의 텍스트를 정수 값으로 변환합니다.

구문

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

매개 변수

[in] hDlg

형식: HWND

관심 있는 컨트롤이 포함된 대화 상자에 대한 핸들입니다.

[in] nIDDlgItem

형식: int

텍스트를 번역할 컨트롤의 식별자입니다.

[out, optional] lpTranslated

형식: BOOL*

성공 또는 실패를 나타냅니다(TRUE 는 성공을 나타내고 FALSE 는 실패를 나타임).

이 매개 변수가 NULL이면 함수는 성공 또는 실패에 대한 정보를 반환하지 않습니다.

[in] bSigned

형식: BOOL

함수가 시작 부분에서 빼기 기호에 대한 텍스트를 검사하고 부호 있는 정수 값을 반환해야 하는지 여부를 나타냅니다(TRUE 는 이 작업을 수행해야 한다고 지정하고 FALSE 는 안 됨).

반환 값

형식: UINT

함수가 성공하면 lpTranslated 가 가리키는 변수가 TRUE로 설정되고 반환 값은 컨트롤 텍스트의 변환된 값입니다.

함수가 실패하면 lpTranslated 가 가리키는 변수가 FALSE로 설정되고 반환 값은 0입니다. 0은 변환 가능한 값이므로 반환 값 0이 실패를 나타내는 것은 아닙니다.

lpTranslated가 NULL인 경우 함수는 성공 또는 실패에 대한 정보를 반환하지 않습니다.

bSigned 매개 변수가 TRUE이고 텍스트 시작 부분에 빼기 기호(–)가 있는 경우 GetDlgItemInt는 텍스트를 부호 있는 정수 값으로 변환합니다. 그렇지 않으면 함수는 부호 없는 정수 값을 만듭니다. 이 경우 적절한 값을 가져오려면 반환 값을 int 형식으로 캐스팅합니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

GetDlgItemInt 함수는 컨트롤에 WM_GETTEXT 메시지를 전송하여 지정된 컨트롤의 텍스트를 검색합니다. 함수는 텍스트의 시작 부분에 있는 추가 공백을 제거한 다음 소수 자릿수를 변환하여 검색된 텍스트를 변환합니다. 함수는 텍스트 끝에 도달하거나 숫자가 아닌 문자를 발견하면 번역을 중지합니다.

변환된 값이 INT_MAX(부호 있는 숫자의 경우) 또는 UINT_MAX(부호 없는 숫자의 경우)보다 크면 GetDlgItemInt 함수는 0을 반환합니다.

예제

예를 들어 모덜리스 대화 상자 만들기를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-dialogbox-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)