다음을 통해 공유

IAgentCharacterEx::GetActive

  • 아티클

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

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

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

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

psState

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

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

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

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

참고 항목

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange