ITextHost::TxActivate 메서드(textserv.h)

컨트롤이 활성 상태임을 텍스트 호스트에 알립니다.

구문

HRESULT TxActivate(
  LONG *plOldState
);

plOldState

형식: LONG*

이전 활성화 상태입니다.

형식: HRESULT

메서드가 성공하면 S_OK 반환합니다.

메서드가 실패하면 다음 COM 오류 코드를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_FAIL	현재 활성화할 수 없습니다.

호스트가 활성화 요청을 거부하는 것은 합법적입니다. 예를 들어 컨트롤이 최소화되어 보이지 않을 수 있습니다.

호출자는 활성화 실패를 정상적으로 처리할 수 있어야 합니다.

이 메서드가 호출된 횟수에 관계없이 컨트롤을 비활성화하려면 하나의 ITextHost::TxDeactivate 호출만 필요합니다.

이 함수는 plOldState에서 불투명 핸들을 반환합니다. 호출자(text services 개체)는 이 핸들을 저장하고 ITextHost::TxDeactivate에 대한 후속 호출에서 사용해야 합니다.

개념

참조