GrayStringA 함수(winuser.h)
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 |