GetDlgItemInt Function

 

728x90

https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getdlgitemint

GetDlgItemInt function (winuser.h)

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

 

Syntax

UINT GetDlgItemInt(
  HWND hDlg,
  int  nIDDlgItem,
  BOOL *lpTranslated,
  BOOL bSigned
);

 

Parameters

 1. hDlg

  1) Type: HWND

  2) control of interest이 포함된 대화 상자의 핸들.

 

 2. nIDDlgItem

  1) Type: int

  2) 텍스트를 변환할 컨트롤의 식별자.

 

 3. lpTranslated

  1) Type: BOOL

  2) 성공 또는 실패를 나타낸다(TRUE는 성공을, FALSE는 실패를 나타냄).

  3) 이 파라미터가 NULL이면 함수는 성공 또는 실패에 대한 정보를 반환하지 않는다.

 

 4. bSigned

  1) Type:: BOOL

  2) 함수가 시작 시 음수 부호에 대해 텍스트를 검사하고 서명된 정수 값을 반환해야 하는지 여부를 나타낸다 (TRUE specifies this should be done, FALSE that it should not).

 

Return Value

 1. Type: UINT

 

 2. 함수가 성공하면 lpTranslated가 가리키는 변수는 TRUE로 설정되며, 반환값은 제어문자의 번역값이다.

 

 3. 함수가 실패하면 lpTranslated가 가리키는 변수는 FALSE로 설정되며, 반환값은 0이다. 0은 가능한 변환된 값이기 때문에 0의 반환 값 자체가 고장을 나타내는 것은 아니라는 점에 유의해라.

 

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

 

 5. bSigned 매개 변수가 TRUE이고 텍스트 시작 부분에 빼기 기호(–)가 있는 경우 GetDlgItemInt는 텍스트를 서명된 정수 값으로 변환한다. 그렇지 않으면 함수는 부호 없는 정수 값을 생성한다. To obtain the proper value in this case, cast the return value to an int type.

 

Remarks

 1. GetDlgItemInt 기능은 WM_GETTEXT 메시지를 컨트롤에 전송하여 지정된 컨트롤의 텍스트를 검색한다. 이 함수는 텍스트 시작 부분에 여분의 공간을 제거한 다음 소수 자릿수를 변환하여 검색된 텍스트를 번역한다. 이 함수는 텍스트의 끝에 도달하거나 숫자가 아닌 문자를 만나면 번역을 중지한다.

 

 2. GetDlgItem변환된 값이 INT_MAX(서명된 번호의 경우) 또는 UINT_MAX(서명되지 않은 번호의 경우)보다 클 경우 Int 함수는 0을 반환한다.

 

Requirements

 1. Minimum supported client

  Windows 2000 Professional [desktop apps only]

 

 2. Minimum supported server

  Windows 2000 Server [desktop apps only]

 

 3. Target Platform

  Windows

 

 4. Header

  winuser.h (include Windows.h)

 

 5. Library

  User32.lib

 

 6. DLL

  User32.dll