IOleInPlaceSiteEx::OnInPlaceActivateEx 메서드(ocidl.h)
활성화 시 자신을 다시 그릴 필요가 있는지 여부를 확인하기 위해 포함된 개체에서 호출됩니다.
구문
HRESULT OnInPlaceActivateEx(
[out] BOOL *pfNoRedraw,
[in] DWORD dwFlags
);
매개 변수
[out] pfNoRedraw
현재 다시 그리기 상태 수신하는 변수에 대한 포인터입니다. 활성화 시 개체를 다시 그릴 필요가 없는 경우 상태 TRUE이고 그렇지 않으면 FALSE입니다. 창 없는 개체는 일반적으로 이 매개 변수에서 반환된 값이 필요하지 않으며 컨테이너에 이 값을 계산하는 부담을 덜어주기 위해 NULL 포인터를 전달할 수 있습니다.
[in] dwFlags
개체가 창 없는 개체로 활성화되는지 여부를 나타냅니다. 이 매개 변수는 ACTIVATEFLAGS 열거형의 값을 사용합니다. 창 없는 개체에 대한 자세한 내용은 IOleInPlaceSiteWindowless 를 참조하세요.
반환 값
컨테이너가 현재 위치 활성화를 허용하는 경우 이 메서드는 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
예기치 않은 오류가 발생했습니다. |
설명
이 메서드는 IOleInPlaceSite::OnInPlaceActivate를 대체합니다. 이전 메서드를 사용하는 경우 개체는 활성화 시 항상 자신을 다시 그려야 합니다.
창 없는 개체는 IOleInPlaceSite::OnInPlaceActivate 대신 이 메서드를 사용하여 컨테이너에 창 없는 활성화 여부를 알리는 데 필요합니다.
구현자에 대한 참고 사항
컨테이너는 개체, 해당 z 순서, 클리핑 및 기타 관련 매개 변수의 무효화 상태 신중하게 검사 pfNoRedraw에서 반환할 적절한 값을 결정해야 합니다.컨테이너는 IOleInPlaceObjectWindowless 인터페이스에서 GetWindow 메서드를 반복적으로 호출하는 대신 ACTIVATEFLAGS 열거형의 값을 캐시할 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | ocidl.h |