다음을 통해 공유


CDC::GetCharacterPlacement

문자열에 대한 다양한 유형의 정보를 검색합니다.

DWORD GetCharacterPlacement(
   LPCTSTR lpString,
   int nCount,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
   CString& str,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;

매개 변수

  • lpString
    처리할 문자열을 가리키는 포인터입니다.

  • nCount
    문자열의 길이를 지정합니다. ANSI 버전의 경우 BYTE 수이고 유니코드 함수의 경우 WORD 수입니다. 자세한 내용은 GetCharacterPlacement를 참조하십시오.

  • nMaxExtent
    문자열 처리(논리 단위)의 최대 범위를 지정합니다. 처리된 경우 이 범위를 초과하는 문자는 무시됩니다. 모든 필요한 주문 또는 문자 모양 배열에 대한 계산은 포함된 문자에만 적용 됩니다. 이 매개 변수는 GCP_MAXEXTENT 값이 dwFlags 매개 변수에 지정된 경우에만 사용됩니다. 함수는 입력 문자열을 처리하므로 각 문자와 그 범위가 출력 범위에 추가되고 총 범위가 아직 최대값을 초과하지 않은 경우에만 다른 배열에 추가됩니다. 한계에 도달하면 처리가 중지됩니다.

  • lpResults
    함수의 결과를 받는 GCP_Results 구조체를 가리키는 포인터입니다.

  • dwFlags
    필요한 배열에 문자열을 처리하는 방법을 지정합니다. 이 매개 변수는 GetCharacterPlacement 항목의 dwFlags 섹션에 나열된 하나 이상의 값일 수 있습니다.

  • str
    처리할 CString 개체에 대한 포인터입니다.

반환 값

함수가 성공하는 경우 반환 값은 논리적 단위로 된 문자열의 너비와 높이입니다.

함수가 실패할 경우에는 0이 반환됩니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 GetCharacterPlacement 함수의 기능을 에뮬레이션합니다.

요구 사항

헤더: afxwin.h

참고 항목

참조

CDC 클래스

계층 구조 차트

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics