Méthode ITextHost ::TxGetViewInset (textserv.h)

  • Article

Demande les dimensions de l’espace blanc incrustant le texte dans la fenêtre hôte de texte.

Syntaxe

HRESULT TxGetViewInset(
  LPRECT prc
);

Paramètres

prc

Type : LPRECT

Taille de l’inset, en coordonnées client. Les membres du haut, du bas, de la gauche et de la droite de la structure RECT indiquent la distance dans chaque sens où le dessin doit être incrusté.

Valeur retournée

Type : HRESULT

La valeur de retour est S_OK.

Remarques

L’incrustage de vue est la quantité d’espace de chaque côté entre le rectangle client et le rectangle d’affichage. Le rectangle d’affichage (également appelé rectangle de mise en forme) est le rectangle dans lequel le texte doit être mis en forme.

Les incrustés de vue sont passés dans une structure RECT , mais il ne s’agit pas vraiment d’un rectangle. Il doit être traité comme quatre valeurs indépendantes à soustraire de chaque côté du rectangle client pour figurer le rectangle d’affichage.

Les incrustages d’affichage sont passés dans HIMETRIC (chaque unité HIMETRIC correspond à 0,01 millimètre) afin qu’ils ne dépendent pas du rectangle client et du contexte du périphérique de rendu.

Les incrustages d’affichage peuvent être négatifs de part et d’autre du rectangle client, ce qui entraîne un rectangle d’affichage plus grand que le rectangle client. Le texte doit ensuite être coupé dans le rectangle client. Si le rectangle d’affichage est plus large que le rectangle client, l’hôte peut ajouter une barre de défilement horizontale au contrôle.

Les objets des services de ligne unique ignorent la limite droite du rectangle d’affichage lors de la mise en forme du texte.

L’incrustage d’affichage est disponible à tout moment à partir de l’hôte, actif ou inactif.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête textserv.h
DLL Msftedit.dll

Voir aussi

ITextHost

Vue d’ensemble des contrôles d’édition enrichis sans fenêtre