Elemento EFFECTS

  • Artículo

[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.

El elemento EFFECTS proporciona una manera de organizar y manipular visualizaciones mediante los siguientes atributos y métodos. También se proporciona un elemento EFFECTS predefinido para mayor comodidad.

El elemento EFFECTS admite los siguientes atributos.

Atributo Descripción
allowAll Especifica o recupera un valor que indica si se deben incluir todas las visualizaciones del Registro.
currentEffect Especifica o recupera la visualización actual.
currentEffectPresetCount Recupera el número de valores preestablecidos disponibles para la visualización actual.
currentEffectTitle Recupera el título para mostrar de la visualización actual.
currentEffectType Recupera el nombre del Registro de la visualización actual.
currentPreset Especifica o recupera el valor preestablecido actual de la visualización actual.
currentPresetTitle Recupera el título del valor preestablecido actual de la visualización actual.
effectCanGoFullScreen Recupera un valor que indica si se puede mostrar la visualización actual en pantalla completa.
effectCount Recupera el número de visualizaciones disponibles.
effectHasPropertyPage Recupera un valor que indica si la visualización actual tiene una página de propiedades.
Fullscreen Especifica o recupera un valor que indica si la visualización actual se muestra en pantalla completa. Solo se puede establecer en tiempo de ejecución.
windowed Especifica o recupera un valor que indica si la visualización se abrirá o no, es decir, si todo el rectángulo del control será visible en todo momento o si se puede recortar. Solo se puede establecer en tiempo de diseño.

 

El elemento EFFECTS admite los métodos siguientes.

Método Descripción
effectTitle Recupera el nombre descriptivo de la visualización con el índice del Registro especificado.
effectType Recupera el nombre del Registro de la visualización con el índice del Registro especificado.
siguiente Muestra el siguiente valor preestablecido de visualización, pasando a la siguiente visualización si es necesario.
nextEffect Muestra el primer valor preestablecido de la siguiente visualización, omitiendo los valores preestablecidos intermedios.
nextPreset Muestra el siguiente valor preestablecido de la visualización actual.
previous Muestra el valor preestablecido de visualización anterior, pasando al último valor preestablecido de la visualización anterior si es necesario.
previousEffect Muestra la visualización anterior, omitiendo los valores preestablecidos.
previousPreset Muestra el valor preestablecido anterior de la visualización actual.
settings Muestra la página de atributos de la visualización actual, si está presente.

 

El elemento EFFECTS admite los atributos ambientales y puede implementar los controladores de eventos de ambiente. Para obtener más información, vea Atributos ambientales y controladores de eventos de ambiente.

Los efectos predefinidos son elementos EFFECTS normales con diversos valores de atributo comunes especificados de forma predeterminada. Están disponibles los siguientes efectos predefinidos.

EFECTOS predefinidos Descripción
WMPEFFECTS Elemento EFFECTS que recorre en iteración los efectos disponibles.

 

Referencia de programación de máscaras