GrayStringA 함수(winuser.h)
GrayString 함수는 지정된 위치에 회색 텍스트를 그립니다. 함수는 텍스트를 메모리 비트맵에 복사하고 비트맵을 회색으로 표시한 다음 비트맵을 화면에 복사하여 그립니다. 이 함수는 선택한 브러시 및 배경에 관계없이 텍스트를 회색으로 표시합니다. GrayString 지정된 디바이스 컨텍스트에 대해 현재 선택된 글꼴을 사용합니다.
thelpOutputFuncparameter가 NULL
통사론
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
출력 함수에 전달할 데이터에 대한 포인터입니다.
[in] nCount
출력할 문자 수입니다.
nCount 매개 변수가 0이면 GrayString 문자열의 길이를 계산합니다(lpData 문자열에 대한 포인터라고 가정).
[in] X
문자열을 묶는 사각형의 시작 위치의 디바이스 x 좌표입니다.
[in] Y
문자열을 묶는 사각형의 시작 위치의 디바이스 y 좌표입니다.
[in] nWidth
문자열을 묶는 사각형의 너비(디바이스 단위)입니다. 이 매개 변수가 0이면 GrayStringlpData 문자열에 대한 포인터라고 가정하여 영역 너비를 계산합니다.
[in] nHeight
문자열을 둘러싸는 사각형의 높이(디바이스 단위)입니다. 이 매개 변수가 0이면 GrayStringlpData 문자열에 대한 포인터라고 가정하여 영역의 높이를 계산합니다.
반환 값
문자열이 그려지면 반환 값은 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 |
참고 항목
drawText
GetSysColor
그리기 및 그리기 함수
SetTextColor
tabbedTextOut
TextOut