Método External.changeView

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

En este tema se describe la funcionalidad diseñada para su uso por las tiendas en línea. No se admite el uso de esta funcionalidad fuera del contexto de una tienda en línea.

El método changeView cambia la vista en Reproductor multimedia de Windows.

Sintaxis

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

Parámetros

LibraryLocationType [in]

Constante de ubicación de biblioteca que especifica el tipo de la nueva vista. Por ejemplo, la constante CPGenreID especifica que la nueva vista mostrará un género determinado.

LibraryLocationID [in]

Cadena que contiene el identificador del elemento específico que se va a mostrar en la nueva vista. Por ejemplo, si LibraryLocationType es CPGenreID, este parámetro especifica el identificador del género que se va a mostrar en la nueva vista. Esta cadena puede estar vacía. Vea la sección Comentarios.

Filtro [in]

Cadena que contiene el filtro de la nueva vista. La vista se filtrará como si el usuario hubiera escrito este texto en el control de rueda de palabras del Reproductor. Esta cadena puede estar vacía.

ViewParams [in]

Cadena que contiene parámetros que Reproductor multimedia de Windows pone a disposición de la nueva página de detección que se muestra con la nueva vista. Estos parámetros no se interpretan mediante Reproductor multimedia de Windows. Son creados por la tienda en línea y tienen significado solo para la tienda en línea.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

En algunos casos, tiene sentido establecer el parámetro LibraryLocationID en la cadena vacía. Por ejemplo, si establece el parámetro LibraryLocationType en AllCPAlbumIDs, la nueva vista representará todos los álbumes. Ningún álbum individual será el foco de la nueva vista, por lo que no es necesario proporcionar un identificador de álbum en el parámetro LibraryLocationID .

El parámetro ViewParams proporciona una manera de que una página de detección se comunique con otra página de detección. Cuando el script de una página de detección llama a changeView, Reproductor multimedia de Windows ajusta su interfaz de usuario. Ese ajuste hace que el reproductor llame al método IWMPContentPartner::GetTemplate del complemento para obtener la dirección URL de una nueva página de detección. La cadena que pasa la página de detección original en el parámetro ViewParams no se pasa a GetTemplate. Sin embargo, la nueva página de detección puede recuperar la cadena ViewParams llamando a External.viewParameters.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows 11.
Archivo DLL	Wmp.dll

Consulte también

Objeto externo para tiendas en línea de tipo 1

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters