IAgentCharacterEx::GetActive

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT GetActive(
   short * psState  // address of active state setting
);

클라이언트 애플리케이션이 문자의 활성 클라이언트인지 여부와 문자가 최상위인지 여부를 검색합니다.

• 작업이 성공했음을 나타내는 S_OK 반환합니다.

psState

상태 설정에 대해 다음 값 중 하나를 수신하는 변수의 주소입니다.

값	설명
const unsigned shortACTIVATE_NOTACTIVE = 0;	클라이언트가 문자의 활성 클라이언트가 아닙니다.
const unsigned shortACTIVATE_ACTIVE = 1;	클라이언트가 문자의 활성 클라이언트입니다.
const unsigned shortACTIVATE_INPUTACTIVE = 2;	클라이언트가 입력 활성(최상위 문자의 활성 클라이언트)입니다.

이 설정을 사용하면 사용자가 문자의 활성 클라이언트인지 또는 문자가 입력 활성 문자인지 여부를 알 수 있습니다. 여러 클라이언트 애플리케이션이 동일한 문자를 공유하는 경우 문자의 활성 클라이언트는 마우스 입력(예: Microsoft 에이전트 컨트롤 클릭 또는 끌기 이벤트)을 받습니다. 마찬가지로 여러 문자가 표시되면 최상위 문자(input-active 클라이언트라고도 함)의 활성 클라이언트는 IAgentNotifySink::Command 이벤트를 받습니다.

Activate 메서드를 사용하여 애플리케이션이 문자의 활성 클라이언트인지 여부를 설정하거나 애플리케이션을 입력 활성 클라이언트로 만듭니다(문자가 맨 위로 표시됨).

참고 항목

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange