Structure FVSHOWINFO (shlobj.h)

Article
03/02/2024

Contient les informations que la visionneuse de fichiers utilise pour afficher un fichier.

Syntaxe

typedef struct {
  DWORD    cbSize;
  HWND     hwndOwner;
  int      iShow;
  DWORD    dwFlags;
  RECT     rect;
  IUnknown *punkRel;
  OLECHAR  strNewFile[MAX_PATH];
} FVSHOWINFO, *LPFVSHOWINFO;

Membres

cbSize

Type : DWORD

Taille de la structure, en octets.

hwndOwner

Type : HWND

Handle de fenêtre pour le propriétaire de la fenêtre dans laquelle le fichier sera affiché.

iShow

Type : int

Commande show pour la fenêtre. Ce paramètre est l’une des valeurs SW_ détaillées dans ShowWindow.

dwFlags

Type : DWORD

Indicateurs qui déterminent ce que la visionneuse de fichiers affiche. Ce membre peut être une ou plusieurs des valeurs suivantes.

FVSIF_CANVIEWIT

La visionneuse de fichiers peut afficher le fichier.

FVSIF_NEWFAILED

La visionneuse de fichiers a spécifié un nouveau fichier à afficher, mais aucune visionneuse ne pouvait afficher le fichier. La visionneuse de fichiers doit continuer à afficher le fichier précédent ou s’arrêter.

FVSIF_NEWFILE

Une opération glisser-déplacer a supprimé un fichier dans la fenêtre de la visionneuse de fichiers. La visionneuse de fichiers transmet le nom du fichier à l’interpréteur de commandes en copiant le nom dans le membre strNewFile . L’interpréteur de commandes tente de charger une visionneuse de fichiers qui peut afficher le nouveau fichier.

FVSIF_PINNED

Une fenêtre épinglée existe. Une visionneuse de fichiers doit utiliser la fenêtre épinglée pour afficher le fichier ou définir une nouvelle fenêtre épinglée et afficher le fichier dans celui-ci.

FVSIF_RECT

Le membre rect contient des données valides.

rect

Type : RECT

Structure RECT qui spécifie la taille et la position de la fenêtre de la visionneuse de fichiers. Ce membre est valide uniquement si le membre dwFlags inclut la valeur FVSIF_RECT .

punkRel

Type : IUnknown*

Adresse d’une interface dont la méthode Release est appelée par une nouvelle visionneuse de fichiers pour libérer la visionneuse de fichiers précédente. Ce membre est utilisé lorsqu’une opération glisser-déplacer dépose un fichier dans la fenêtre de la visionneuse de fichiers.

strNewFile[MAX_PATH]

Type : OLECHAR[MAX_PATH]

Adresse d’une chaîne qui spécifie le nom d’un nouveau fichier à afficher. Une visionneuse de fichiers définit ce membre lorsqu’une opération glisser-déplacer dépose un fichier dans la fenêtre de la visionneuse de fichiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	shlobj.h

Partager via