Structure OLEUICHANGESOURCEA (oledlg.h)

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 de cellules dans la feuille de calcul vers laquelle le lien est lié.

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. À 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 de 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 propriétaire de la boîte de dialogue.

lpszCaption

Pointeur vers une chaîne à utiliser comme titre de la boîte de dialogue. Si NULL, la bibliothèque utilise modifier lasource .

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction de raccordement doit retourner zéro pour transmettre un message qu’elle n’a pas réappuché à la procédure de boîte de dialogue dans la bibliothèque. La fonction de 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 de raccordement 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 null qui spécifie le nom du fichier de ressources du modèle de boîte de dialogue à remplacer par le modèle de boîte de dialogue Convertir modèle de boîte de dialogue de la bibliothèque.

hResource

Handle de ressource pour une boîte de dialogue personnalisée. Si ce membre est 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 des 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 utilise cette option pour permettre au conteneur de manipuler ses liens.

dwLink

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

lpszDisplayName

Pointeur vers le nom complet de l’affichage source.

nFileLength

Partie moniker de fichier de lpszDisplayName.

lpszFrom

Pointeur vers le préfixe de la source qui a été modifiée.

lpszTo

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

Remarques

Note

L’en-tête oledlg.h définit OLEUICHANGESOURCE comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	oledlg.h

Voir aussi

IOleUILinkContainer

OleUIChangeSource