GetDlgItem 함수(winuser.h)

아티클
03/13/2024

지정된 대화 상자에서 컨트롤에 대한 핸들을 검색합니다.

구문

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

매개 변수

[in, optional] hDlg

형식: HWND

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

[in] nIDDlgItem

형식: int

검색할 컨트롤의 식별자입니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 지정된 컨트롤의 창 핸들입니다.

함수가 실패하면 반환 값은 NULL로, 잘못된 대화 상자 핸들 또는 존재하지 않는 컨트롤을 나타냅니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

GetDlgItem 함수는 대화 상자뿐만 아니라 부모-자식 창 쌍과 함께 사용할 수 있습니다. hDlg 매개 변수가 부모 창을 지정하고 자식 창에 고유 식별자가 있는 한(자식 창을 만든 CreateWindow 또는 CreateWindowEx 함수의 hMenu 매개 변수에 지정된 대로) GetDlgItem은 자식 창에 유효한 핸들을 반환합니다.

예제

예제는 대화 상자 초기화를 참조하세요.

요구 사항

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