ExtTextOutWrap 함수

[ExtTextOutWrap은 Windows XP SP2(서비스 팩 2)를 통해 사용할 수 있습니다. 후속 버전에서 변경되거나 사용하지 못할 수 있습니다. 대신 ExtTextOut을 직접 사용하는 것이 좋습니다.]

현재 선택한 글꼴, 배경색 및 텍스트 색을 사용하여 텍스트를 그립니다. 필요에 따라 클리핑, 불투명도 또는 둘 다에 사용할 차원을 제공할 수 있습니다. 이 함수는 ExtTextOut에 대한 호출을 래핑합니다.

구문

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

매개 변수

hdc[in]

형식: HDC

디바이스 컨텍스트에 대한 핸들입니다.

X[in]

형식: int

문자열을 배치하는 데 사용되는 참조 지점의 x 좌표(논리적 좌표)입니다.

Y[in]

형식: int

문자열을 배치하는 데 사용되는 참조 지점의 y 좌표(논리적 좌표)입니다.

uOptions[in]

형식: UINT

애플리케이션 정의 사각형을 사용하는 방법을 지정하는 값입니다. 전체 옵션 목록은 ExtTextOut을 참조하세요.

lprc[in]

형식: const RECT*

클리핑, 불투명도 또는 둘 다에 사용되는 사각형의 차원(논리적 좌표)을 지정하는 선택적 RECT 구조체에 대한 포인터입니다.

lpString[in]

형식: LPCTSTR

그릴 텍스트가 포함된 버퍼에 대한 포인터입니다. cbCount는 문자열의 길이를 지정하므로 문자열을 0으로 종료할 필요가 없습니다.

cbCount[in]

형식: UINT

lpString이 가리키는 문자열의 길이(바이트)입니다.

lpDx[in]

형식: const INT*

인접한 문자 셀의 원점 사이 거리를 나타내는 값의 선택적 배열에 대한 포인터입니다. 예를 들어 lpDx[x] 논리 단위는 x 문자 셀 및 (x + 1) 문자 셀의 원점을 구분합니다.

반환 값

형식: BOOL

문자열이 성공적으로 그려지면 0이 아닌 값을 반환합니다. 그러나 extTextOut의 ANSI 버전이 ETO_GLYPH_INDEX와 함께 호출되는 경우 함수는 아무 작업도 수행하지 않더라도 TRUE를 반환합니다.

함수가 실패하면 반환 값은 0입니다.

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

설명

ExtTextOutWrap은 이름으로 내보내거나 퍼블릭 헤더 파일에서 선언되지 않습니다. 이를 사용하려면 GetProcAddress를 사용하고 ComCtl32.dll에서 서수 417을 요청하여 함수 포인터를 얻어야 합니다.

추가 설명은 ExtTextOut을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
DLL	Comctl32.dll(버전 6.0 이상)