GetSysColorBrush

GetSysColorBrush

지정된 시스템 칼라(각각의 디스플레이 요소로 현재 사용되고 있는 색)에 대응하는 논리 브러쉬의 핸들을 취득합니다.

HBRUSH GetSysColorBrush(
    int  nIndex    // 시스템 칼라의 인덱스
);

USER32.DLL

인수

nIndex

시스템 칼라의 인덱스를 지정합니다. GetSysColor 함수의 nIndex 파라미터로 지정되는 값을 지정합니다.

반환값

nIndex 파라미터로 지정된 칼라 인덱스가 현재의 플랫폼에서 서포트되고 있는 경우는, 논리 브러쉬의 핸들이 돌아갑니다.

그 이외의 경우는 0 (NULL) 하지만 돌아갑니다.

해설

어플리케이션은, 윈도우 클래스를 등록할 경우에 GetSysColorBrush 함수로 취득되는 시스템 브러쉬를 사용 해서는 안됩니다.

유저에 의해서 시스템 칼라가 변경되었을 경우에, 관련하는 시스템 칼라 브러쉬는 자동적으로 새로운 브러쉬로 변경됩니다.

GetSysColorBrush 함수는, 새로운 브러쉬를 작성하는 것이 아니라, 캐쉬되고 있는 브러쉬를 돌려줍니다.따라서, 시스템 칼라의 브러쉬를 사용해 묘화 하는 경우에는, CreateSolidBrush 함수로 브러쉬를 작성하는 것은이 아니고, GetSysColorBrush 함수를 사용해 취득한 브러쉬를 사용해야 합니다.

시스템 칼라 브러쉬는 시스템에 의해서 소유되고 있습니다.이 브러쉬를 삭제 해서는 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후