External.NavigateTaskPaneURL 메서드

  • 아티클

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

참고

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

NavigateTaskPaneURL 메서드는 지정된 작업창에서 웹 페이지를 열고 포커스를 지정된 창으로 변경합니다.

구문

External.NavigateTaskPaneURL(
  bstrKeyName,
  bstrTaskPane,
  bstrParams
)

매개 변수

bstrKeyName [in]

온라인 저장소의 키 이름을 포함하는 문자열입니다. (필수)

bstrTaskPane [in]

웹 페이지가 열리는 작업창의 이름을 포함하는 문자열입니다. (필수)

bstrParams [in]

ServiceInfo 문서의 Navigate 요소에 지정된 URL에 추가할 쿼리 문자열 매개 변수를 포함하는 문자열입니다. (선택 사항)

반환 값

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

설명

온라인 스토어에서 지원하지 않는 창으로 이동하면 현재 온라인 저장소가 변경될 수 있습니다.

bstrParams에 지정된 값은 온라인 저장소에서 제공하는 웹 페이지에서 NavigateTaskPaneURL이 호출되는 경우에만 유효합니다.

다음 표에는 bstrTaskPane 에 대한 유효한 값과 각각에 대한 연결된 작업창이 나열되어 있습니다.

값 작업창
ServiceTask1 첫 번째 온라인 스토어 작업창.
ServiceTask2 두 번째 온라인 스토어 작업창.
ServiceTask3 세 번째 온라인 스토어 작업창.

웹 페이지 코드는 탐색이 완료된 후 올바른 작업창 단추가 강조 표시되도록 로드할 때 External.SelectedTaskPane 값을 지정해야 합니다.

예제

다음 예제 코드에서는 NavigateTaskPaneURL 이 ServiceTask1에 표시할 웹 페이지의 URL을 만드는 방법을 보여 줍니다.

Navigate 요소의 예:

<Navigate
    BaseURL = "https://www.proseware.com/online store/html/navigate.asp">
</Navigate>

NavigateTaskPaneURL 메서드에 대한 예제 호출:

external.NavigateTaskPaneURL("Proseware", "ServiceTask1", "Pane=Store");

ServiceTask1에 표시된 웹 페이지에 사용되는 결과 URL의 예:

https://www.proseware.com/online store/html/navigate.asp?Pane=Store

요구 사항

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

추가 정보

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

External.SelectedTaskPane