DGGetFocus

키보드 포커스를 갖고 있는 항목 인덱스와 항목의 다이얼로그 식별자를 가져옵니다.

    void DGGetFocus (
      short   dialId,
      short*  focusDial,
      short*  focusItem
    );

파라미터

dialId

다이얼로그의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다. DG_ALL_DIALOGS 역시 여기서 사용할 수 있습니다.

 

focusDial

출력 파라미터: 포커스된 항목의 다이얼로그 또는 탭 페이지 식별자입니다. 이 파라미터는 NULL이 될 수 있습니다.

 

focusItem

출력 파라미터: 포커스된 항목의 1-기반 인덱스입니다. 이 파라미터는 NULL이 될 수 있습니다.

설명

만약 dialId가 DG_ALL_DIALOGS이면, 포커스된 항목에 대하여 모든 열린 다이얼로그들을 검색합니다. 현재 포커스된 다이얼로그와 다이얼로그 항목을 가져오기 위해 이 값을 사용하십시오.

이와 반대로, 주어진 다이얼로그 ID로 이 함수를 호출하여 항목들 중 어떤 것이 키보드 포커스를 갖고 있는지 여부를 테스트할 수 있습니다.

만약 함수 파라미터들이 올바르지 않거나, 지정한 다이얼로그가 키보드 포커스를 갖고 있지 않거나, 탭 페이지이면, focusDial과 focusItem 둘 다 0이 리턴됩니다.

만약 포인터 파라미터들 중 하나가 NULL이면, 값을 리턴하지 않습니다.

DG에서 키보드 포커스와 포커스 가능한 컨트롤 카테고리들은 Macintosh 운영체제에서 동일한 의미를 갖습니다. (즉, DG에서나 Macintosh에서나 동일한 타입의 컨트롤들이 포커스 가능합니다) 그러나 Windows에서는 더 많은 컨트롤들이 키보드 포커스를 가질 수 있습니다. DG의 포커스 가능한 컨트롤들은 Windows의 포커스 가능한 컨트롤들의 부분 집합입니다. DGGetFocus와 DGSetFocus 함수는 DG의 포커스 가능한 컨트롤들에서만 작동합니다.

DG에서 다음 컨트롤들이 포커스 가능합니다: 날짜 & 시간 컨트롤, Edit 컨트롤, 리스트 박스, 리스트 뷰, 트리 뷰.

요구사항

버전: DG 1.0.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, DGSetFocus
날짜 & 시간 컨트롤, Edit 컨트롤, 리스트 박스, 리스트 뷰, 트리 뷰