Propriété AxWindowsMediaPlayer.uiMode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La propriété uiMode obtient ou définit une valeur indiquant les contrôles affichés dans l’interface utilisateur.

Syntaxe

public System.String uiMode {get; set;}

Public Property uiMode As System.String

Valeur de la propriété

System.String qui est l’une des valeurs suivantes.

Valeur	Description	Exemple audio	Exemple vidéo
invisibles	Lecteur multimédia Windows est incorporé sans interface utilisateur visible (contrôles, fenêtre vidéo ou visualisation).	(Rien n’est affiché.)	(Rien n’est affiché.)
aucun	Lecteur multimédia Windows est incorporé sans contrôles et avec uniquement la vidéo ou la fenêtre de visualisation affichée.
mini	Lecteur multimédia Windows est incorporé avec les contrôles de fenêtre de status, de lecture/pause, d’arrêt, de muet et de volume affichés en plus de la fenêtre vidéo ou de visualisation.
complet	Par défaut. Lecteur multimédia Windows est incorporé à la fenêtre status, à la barre de recherche, à la lecture/pause, à l’arrêt, au son, à la mise en sourdine, à l’avance rapide, au rembobinage et aux contrôles de volume en plus de la fenêtre vidéo ou de visualisation.
custom	Lecteur multimédia Windows est incorporé avec une interface utilisateur personnalisée. Ne peut être utilisé que dans les programmes C++.	(L’interface utilisateur personnalisée s’affiche.)	(L’interface utilisateur personnalisée s’affiche.)

Notes

Cette propriété spécifie l’apparence du Lecteur multimédia Windows incorporé. Lorsque uiMode est défini sur « none », « mini » ou « full », une fenêtre est présente pour l’affichage des clips vidéo et des visualisations audio. Cette fenêtre peut être masquée en mode mini ou complet en définissant l’attribut height de la balise OBJECT sur 40, qui est mesuré à partir du bas, et laisse la partie contrôles de l’interface utilisateur visible. Si aucune interface incorporée n’est souhaitée, définissez les attributs width et height sur zéro.

Si uiMode est défini sur « invisible », aucune interface utilisateur n’est affichée, mais l’espace est toujours réservé sur la page, comme spécifié par largeur et hauteur. Cela est utile pour conserver la mise en page lorsque uiMode peut changer. En outre, l’espace réservé étant transparent, tous les éléments superposés derrière le contrôle seront visibles.

Si uiMode est défini sur « full » ou « mini », Lecteur multimédia Windows affiche les contrôles de transport en mode plein écran. Si uiMode est défini sur « none », aucun contrôle n’est affiché en mode plein écran.

Si la fenêtre est visible et que du contenu audio est lu, la visualisation affichée est celle utilisée le plus récemment dans Lecteur multimédia Windows.

Si uiMode est défini sur « personnalisé » dans un programme C++ qui implémente IWMPRemoteMediaServices, le fichier d’apparence indiqué par IWMPRemoteMediaServices.GetCustomUIMode s’affiche.

Pendant la lecture en plein écran, Lecteur multimédia Windows masque le curseur de la souris lorsque enableContextMenu est égal à false et que uiMode est égal à « none ».

Exemples

L’exemple suivant crée une zone de liste qui permet à l’utilisateur de modifier le mode d’interface utilisateur d’un objet Lecteur multimédia Windows incorporé. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

// Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible");
uiModeOptions.Items.Add("none");
uiModeOptions.Items.Add("mini");
uiModeOptions.Items.Add("full");


private void uiModeOptions_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    // Get the selected UI mode in the list box as a string.
    string newMode = (string)(((System.Windows.Forms.ListBox)sender).SelectedItem);
     
    // Set the UI mode that the user selected.
    player.uiMode = newMode;            
}

' Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible")
uiModeOptions.Items.Add("none")
uiModeOptions.Items.Add("mini")
uiModeOptions.Items.Add("full")


Public Sub uiModeOptions_OnSelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles uiModeOptions.SelectedIndexChanged

    ' Get the selected UI mode in the list box as a string.
    Dim lb As System.Windows.Forms.ListBox = sender
    Dim newMode As String = lb.SelectedItem

    ' Set the UI mode that the user selected.
    player.uiMode = newMode

End Sub

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure. Lecteur multimédia Windows Série 9 ou ultérieure pour « invisible » ou « personnalisé »
Espace de noms	AxWMPLib
Assembly	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

Voir aussi

Objet AxWindowsMediaPlayer (VB et C#)

AxWindowsMediaPlayer.enableContextMenu (VB et C#)