Partager via

Méthode IOleObject ::SetHostNames (oleidl.h)

  • Article

Fournit un objet avec les noms de son application conteneur et le document composé dans lequel il est incorporé.

Syntaxe

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

Paramètres

[in] szContainerApp

Pointeur vers le nom de l'application conteneur dans laquelle l'objet s'exécute.

[in] szContainerObj

Pointeur vers le nom du document composé qui contient l'objet. Si vous ne souhaitez pas afficher le nom du document composé, vous pouvez définir ce paramètre sur NULL.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite.

Remarques

Remarques pour les appelants

Appelez IOleObject ::SetHostNames uniquement pour les objets incorporés , car pour les objets liés, la source de lien fournit ses propres informations de fenêtre d’édition et de barre de titre distinctes.

Notes aux implémenteurs

L’application IOleObject ::SetHostNames d’un objet doit inclure toutes les modifications de son interface utilisateur qui peuvent être appropriées à l’état incorporé d’un objet. Ces modifications incluent généralement l’ajout et la suppression de commandes de menu et la modification du texte affiché dans la barre de titre de la fenêtre d’édition.

Le titre complet de la fenêtre d’un objet incorporé dans une application conteneur SDI ou une application MDI avec une fenêtre enfant agrandie doit apparaître comme suit :

<object application name> - <object short type> in <container document>

Sinon, le titre doit être :

<object application name> - <container document>

Le « type court d’objet » fait référence à une forme de nom d’objet suffisamment courte pour être affichée dans une zone de liste. Étant donné que ces chaînes d’identification ne sont pas stockées dans le cadre de l’état persistant de l’objet, IOleObject ::SetHostNames doit être appelé chaque fois que l’objet se charge ou s’exécute.

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]
Plateforme cible Windows
En-tête oleidl.h

Voir aussi

IOleObject

IOleObject ::GetUserType