IOleInPlaceSiteEx::OnInPlaceActivateEx 메서드(ocidl.h)

아티클
02/29/2024

활성화 시 자신을 다시 그릴 필요가 있는지 여부를 확인하기 위해 포함된 개체에서 호출됩니다.

구문

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

매개 변수

[out] pfNoRedraw

현재 다시 그리기 상태 수신하는 변수에 대한 포인터입니다. 활성화 시 개체를 다시 그릴 필요가 없는 경우 상태 TRUE이고 그렇지 않으면 FALSE입니다. 창 없는 개체는 일반적으로 이 매개 변수에서 반환된 값이 필요하지 않으며 컨테이너에 이 값을 계산하는 부담을 덜어주기 위해 NULL 포인터를 전달할 수 있습니다.

[in] dwFlags

개체가 창 없는 개체로 활성화되는지 여부를 나타냅니다. 이 매개 변수는 ACTIVATEFLAGS 열거형의 값을 사용합니다. 창 없는 개체에 대한 자세한 내용은 IOleInPlaceSiteWindowless 를 참조하세요.

반환 값

컨테이너가 현재 위치 활성화를 허용하는 경우 이 메서드는 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.

설명

이 메서드는 IOleInPlaceSite::OnInPlaceActivate를 대체합니다. 이전 메서드를 사용하는 경우 개체는 활성화 시 항상 자신을 다시 그려야 합니다.

창 없는 개체는 IOleInPlaceSite::OnInPlaceActivate 대신 이 메서드를 사용하여 컨테이너에 창 없는 활성화 여부를 알리는 데 필요합니다.

구현자에 대한 참고 사항

컨테이너는 개체, 해당 z 순서, 클리핑 및 기타 관련 매개 변수의 무효화 상태 신중하게 검사 pfNoRedraw에서 반환할 적절한 값을 결정해야 합니다.

컨테이너는 IOleInPlaceObjectWindowless 인터페이스에서 GetWindow 메서드를 반복적으로 호출하는 대신 ACTIVATEFLAGS 열거형의 값을 캐시할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h