commande window
La commande window contrôle la fenêtre d’affichage. Vous pouvez utiliser cette commande pour modifier les caractéristiques d’affichage de la fenêtre ou fournir une fenêtre de destination que le pilote doit utiliser à la place de la fenêtre d’affichage par défaut. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande.
Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.
_stprintf_s(
lpszCommand,
TEXT("window %s %s %s"),
lpszDeviceID,
lpszWindowFlags,
lpszFlags
);
Paramètres
-
lpszDeviceID
-
Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.
-
lpszWindowFlags
-
Indicateur de contrôle de la fenêtre d’affichage. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande window et les indicateurs utilisés par chaque type.
Valeur Signification Signification digitalvideo handle hwnd state hidestate minimizestate restorestate showshow agrandi show minimizedshow min noactiveshow nashow noactivateshow normaltext légende superposition fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimisstate minimisdstate no actionstate noactivatestate normal state restorestate showshow maximizedshow minimisdshow min noactiveshow nashow noactivateshow normalstretchtext légende Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszWindowFlags et leurs significations.
Valeur Signification fixe Désactive l’étirement de l’image. gérer par défaut Spécifie que l’appareil doit revenir à la fenêtre d’affichage par défaut créée pendant l’opération d’ouverture . Pour les appareils de superposition vidéo, spécifie que l’appareil doit créer et gérer sa propre fenêtre de destination. handle hwnd Spécifie le handle de la fenêtre de destination à utiliser au lieu de la fenêtre par défaut. Le paramètre hwnd contient l’équivalent numérique ASCII du handle de fenêtre retourné par la fonction CreateWindow . Deux instances d’appareil peuvent utiliser le même handle de fenêtre, à condition que chaque instance met à jour les pixels vidéo et image dans la fenêtre comme si l’autre instance n’existait pas. Lorsque la sortie vidéo est désactivée avec setvideo « off », une commande de mise à jour rend le rectangle de destination une couleur unie. afficher agrandi Agrandit la fenêtre de destination. afficher min noactive Affiche la fenêtre de destination sous forme d’icône. afficher minimisé Réduit la fenêtre de destination. show na Affiche la fenêtre de destination dans son état actuel ; la fenêtre actuellement active reste active. afficher noactivate Affiche la fenêtre de destination dans sa taille et sa position les plus récentes ; la fenêtre actuellement active reste active. afficher la normale Active et affiche la fenêtre de destination dans sa taille et sa position d’origine. (Il s’agit de l’indicateur « restauration d’état ». masquer l’état Masque la fenêtre de destination. icône d’état Affiche la fenêtre de destination sous forme d’icône. état agrandi Agrandit la fenêtre de destination. réduire l’état Réduit la fenêtre de destination et active la fenêtre de niveau supérieur dans la liste du gestionnaire de fenêtres. état réduit Réduit la fenêtre de destination. état aucune action Affiche la fenêtre de destination dans son état actuel. La fenêtre actuellement active reste active. état noactivate Affiche la fenêtre de destination dans sa taille et son état les plus récents. La fenêtre actuellement active reste active. état normal Active et affiche la fenêtre de destination dans sa taille et sa position d’origine. restauration d’état Active et affiche la fenêtre de destination dans sa taille et sa position d’origine. state show Affiche la fenêtre de destination. étirement Active l’étirement de l’image. légende texte Spécifie le légende de la fenêtre de destination. Si ce texte contient des vides incorporés, l’ensemble du légende doit être placé entre guillemets. La légende par défaut de la fenêtre par défaut est vide. -
lpszFlags
-
Peut être « attendre », « notifier » ou les deux. Pour les appareils vidéo numériques, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.
Valeur renvoyée
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.
Notes
Les appareils de superposition vidéo créent et affichent généralement une fenêtre lorsqu’ils sont ouverts. Si votre application fournit une fenêtre au pilote, elle est responsable de la gestion des messages envoyés à la fenêtre.
Étant donné que vous pouvez utiliser la commande status pour récupérer le handle de la fenêtre d’affichage du pilote, vous pouvez également utiliser les fonctions standard du gestionnaire de fenêtres (telles que ShowWindow) pour manipuler la fenêtre.
Exemples
La commande suivante affiche et définit les légende pour la fenêtre de lecture « film ».
window movie text "Welcome to the Movies" state show
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |