Structure OLEUICHANGESOURCEA (oledlg.h)

Article
08/25/2023

Contient des informations utilisées pour initialiser la boîte de dialogue Modifier la source standard. Il permet à l’utilisateur de modifier la destination ou la source d’un lien. Cela peut simplement impliquer la sélection d’un autre nom de fichier pour le lien, ou éventuellement la modification de la référence d’élément dans le fichier, par exemple, la modification de la plage de destination des cellules dans la feuille de calcul à laquelle le lien est destiné.

Syntaxe

typedef struct tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

Membres

cbStruct

Taille de la structure, en octets.

dwFlags

Lors de l’entrée, ce champ spécifie les indicateurs d’initialisation et de création. Lors de la sortie, il spécifie les choix de l’utilisateur. Il peut s’agir d’une combinaison des indicateurs suivants.

Valeur	Signification
CSF_SHOWHELP	Active ou affiche le bouton Aide.
CSF_VALIDSOURCE	Indique que le lien a été validé.
CSF_ONLYGETSOURCE	Désactive la validation automatique de la source du lien lorsque l’utilisateur appuie sur OK. Si vous spécifiez cet indicateur, vous devez valider la source lorsque la boîte de dialogue retourne OK.

hWndOwner

Fenêtre qui possède la boîte de dialogue.

lpszCaption

Pointeur vers une chaîne à utiliser comme titre de la boîte de dialogue. Si la valeur est NULL, la bibliothèque utilise Modifier la source.

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction hook doit retourner zéro pour transmettre un message qu’elle n’a pas retransmise à la procédure de boîte de dialogue dans la bibliothèque. La fonction hook doit retourner une valeur différente de zéro pour empêcher la procédure de boîte de dialogue de la bibliothèque de traiter un message qu’elle a déjà traité.

lCustData

Données définies par l’application que la bibliothèque transmet à la fonction hook pointée par la structure OLEUICHANGEICON dans le paramètre lParam du message WM_INITDIALOG ; ce pointeur peut être utilisé pour récupérer le membre lCustData .

hInstance

Instance qui contient un modèle de boîte de dialogue spécifié par le membre lpszTemplate . Ce membre est ignoré si le membre lpszTemplate est NULL ou non valide.

lpszTemplate

Pointeur vers une chaîne terminée par un caractère Null qui spécifie le nom du fichier de ressources pour le modèle de boîte de dialogue qui doit être remplacé par le modèle de boîte de dialogue Convertir de la bibliothèque.

hResource

Handle de ressource pour une boîte de dialogue personnalisée. Si ce membre a la valeur NULL, la bibliothèque utilise le modèle de boîte de dialogue Convertir standard ou, s’il est valide, le modèle nommé par le membre lpszTemplate .

lpOFN

Pointeur vers la structure OPENFILENAME , qui contient les informations utilisées par le système d’exploitation pour initialiser les boîtes de dialogue Ouvrir ou Enregistrer sous définies par le système.

dwReserved1[4]

Ce membre est réservé.

lpOleUILinkContainer

Pointeur vers l’implémentation du conteneur de l’interface IOleUILinkContainer , utilisée pour valider la source du lien. La boîte de dialogue Modifier les liens l’utilise pour permettre au conteneur de manipuler ses liens.

dwLink

Identificateur de lien unique défini par le conteneur utilisé pour valider les sources de liens. Utilisé par lpOleUILinkContainer.

lpszDisplayName

Pointeur vers le nom complet de la source.

nFileLength

File moniker portion de lpszDisplayName.

lpszFrom

Pointeur vers le préfixe de la source à partir de laquelle a été modifiée.

lpszTo

Pointeur vers le préfixe de la source à modifier.

Remarques

Notes

L’en-tête oledlg.h définit OLEUICHANGESOURCE en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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]
En-tête	oledlg.h

Voir aussi

IOleUILinkContainer

OleUIChangeSource

Partager via