GrayStringA 함수(winuser.h)

아티클
08/27/2023

GrayString 함수는 지정된 위치에 회색 텍스트를 그립니다. 함수는 텍스트를 메모리 비트맵에 복사하고 비트맵을 회색으로 표시한 다음 비트맵을 화면에 복사하여 그립니다. 함수는 선택한 브러시 및 배경에 관계없이 텍스트를 회색으로 표시합니다. GrayString 은 지정된 디바이스 컨텍스트에 대해 현재 선택된 글꼴을 사용합니다.

thelpOutputFuncparameter가 NULL이면 GDI 는 TextOut 함수를 사용하고, thelpDataparameter는 출력할 문자열에 대한 포인터로 간주됩니다. 출력할 문자를 TextOut 에서 처리할 수 없는 경우(예: 문자열이 비트맵으로 저장됨) 애플리케이션은 자체 출력 함수를 제공해야 합니다.

구문

BOOL GrayStringA(
  [in] HDC            hDC,
  [in] HBRUSH         hBrush,
  [in] GRAYSTRINGPROC lpOutputFunc,
  [in] LPARAM         lpData,
  [in] int            nCount,
  [in] int            X,
  [in] int            Y,
  [in] int            nWidth,
  [in] int            nHeight
);

매개 변수

[in] hDC

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

[in] hBrush

회색으로 사용할 브러시에 대한 핸들입니다. 이 매개 변수가 NULL이면 창 텍스트를 그리는 데 사용된 것과 동일한 브러시로 텍스트가 회색으로 표시됩니다.

[in] lpOutputFunc

문자열을 그릴 애플리케이션 정의 함수에 대한 포인터이거나, TextOut 을 사용하여 문자열을 그리는 경우 NULL 포인터입니다. 자세한 내용은 OutputProc 콜백 함수를 참조하세요.

[in] lpData

출력 함수에 전달할 데이터에 대한 포인터입니다. lpOutputFunc 매개 변수가 NULL인 경우 lpData는 출력할 문자열에 대한 포인터여야 합니다.

[in] nCount

출력할 문자 수입니다. nCount 매개 변수가 0이면 GrayString은 문자열의 길이를 계산합니다(lpData가 문자열에 대한 포인터라고 가정). nCount가 1이고 lpOutputFunc가 가리키는 함수가 FALSE를 반환하면 이미지가 표시되지만 회색으로 표시되지는 않습니다.

[in] X

문자열을 묶는 사각형의 시작 위치의 디바이스 x 좌표입니다.

[in] Y

문자열을 묶는 사각형의 시작 위치의 디바이스 y 좌표입니다.

[in] nWidth

문자열을 묶는 사각형의 너비(디바이스 단위)입니다. 이 매개 변수가 0이면 lpData가 문자열에 대한 포인터라고 가정하여 GrayString에서 영역의 너비를 계산합니다.

[in] nHeight

문자열을 묶는 사각형의 높이(디바이스 단위)입니다. 이 매개 변수가 0이면 lpData가 문자열에 대한 포인터라고 가정하여 GrayString에서 영역의 높이를 계산합니다.

반환 값

문자열이 그려지면 반환 값은 0이 아닌 값입니다.

TextOut 함수 또는 애플리케이션 정의 출력 함수가 0을 반환하거나 메모리가 부족하여 회색으로 표시할 메모리 비트맵을 만들 수 없는 경우 반환 값은 0입니다.

설명

GrayString을 호출하지 않고 애플리케이션은 단색 회색을 지원하는 디바이스에서 회색 문자열을 그릴 수 있습니다. 시스템 색 COLOR_GRAYTEXT 비활성화된 텍스트를 그리는 데 사용되는 단색 시스템 색입니다. 애플리케이션은 GetSysColor 함수를 호출하여 COLOR_GRAYTEXT 색 값을 검색할 수 있습니다. 색이 0(검정)이 아닌 경우 애플리케이션은 SetTextColor 함수를 호출하여 텍스트 색을 색 값으로 설정한 다음 문자열을 직접 그릴 수 있습니다. 검색된 색이 검은색이면 애플리케이션에서 GrayString을 호출하여 텍스트를 회색으로 표시해야 합니다.

참고

winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 GrayString을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll