External.cancelNavigate 메서드

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

참고

이 항목에서는 온라인 스토어에서 사용하도록 설계된 기능에 대해 설명합니다. 온라인 스토어의 컨텍스트 외부에서는 이 기능을 사용할 수 없습니다.

cancelNavigate 메서드는 Windows 미디어 플레이어 플레이어에서 보기가 변경된 경우에도 새 검색 페이지를 표시해서는 안 됨을 알 수 있습니다.

구문

External.cancelNavigate()

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

Windows 미디어 플레이어 보기가 변경되면 플레이어는 온라인 스토어의 플러그 인을 호출하여 다음에 표시할 검색 페이지를 결정합니다. 그러나 경우에 따라 온라인 스토어에서 플레이어가 기존 검색 페이지를 계속 표시하도록 할 수 있습니다. 다음 프로세스는 플레이어가 새 검색 페이지를 표시할지 여부를 결정합니다.

1. 플레이어의 사용자 인터페이스 또는 검색 페이지에서 사용자가 수행한 작업은 플레이어의 보기를 변경해 달라는 요청입니다.
2. Player는 플러그 인의 GetTemplate 메서드를 호출하여 다음에 표시할 검색 페이지를 결정합니다. 플레이어는 새 검색 페이지의 URL을 저장하지만 현재는 새 검색 페이지를 표시하지 않습니다.
3. 플레이어가 OnViewChange 이벤트를 발생합니다.
4. 검색 페이지의 OnViewChange 이벤트 처리기가 cancelNavigate를 호출하는 경우 플레이어는 새 검색 페이지(2단계에서 결정됨)를 표시하지 않습니다. 대신 기존 검색 페이지를 계속 표시합니다. OnViewChange 이벤트 처리기가 cancelNavigate를 호출하지 않으면 플레이어가 새 검색 페이지를 표시합니다.

예를 들어 플레이어가 현재 특정 트랙이 선택된 앨범의 보기를 표시하고 있다고 가정해 보겠습니다. 또한 현재 검색 페이지가 전체 앨범을 나타내는 페이지라고 가정합니다. 사용자가 같은 앨범에서 다른 트랙을 클릭하면 플레이어 보기가 약간 변경되어 새 트랙이 선택되었음을 표시합니다. 그러나 새 검색 페이지를 표시할 필요는 없습니다. 전체 앨범을 나타내는 검색 페이지는 여전히 플레이어가 표시하기에 적합한 페이지입니다.

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 11.
DLL	Wmp.dll

추가 정보

유형 1 온라인 저장소에 대한 외부 개체

External.changeViewOnlineList

External.OnViewChange