ITextHost::TxGetViewInset-Methode (textserv.h)

Fordert die Abmessungen des Leerzeichens um den Text im Texthostfenster an.

Syntax

HRESULT TxGetViewInset(
  LPRECT prc
);

Parameter

prc

Typ: LPRECT

Die Eingangsgröße in Clientkoordinaten. Die oberen, unteren, linken und rechten Elemente der RECT-Struktur geben an, wie weit die Zeichnung in jede Richtung eingelassen werden soll.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist S_OK.

Hinweise

Der Sichteinsatz ist der Speicherplatz auf jeder Seite zwischen dem Clientrechteck und dem Sichtrechteck. Das Ansichtsrechteck (auch als Formatierungsrechteck bezeichnet) ist das Rechteck, in dem der Text formatiert werden soll.

Die Ansichtseinsets werden in einer RECT-Struktur übergeben, aber dies ist nicht wirklich ein Rechteck. Es sollte als vier unabhängige Werte behandelt werden, die auf jeder Seite des Clientrechtecks subtrahiert werden, um das Ansichtsrechteck zu ermitteln.

Die Ansichtseinsätze werden in HIMETRIC übergeben (jede HIMETRIC-Einheit entspricht 0,01 Millimeter), sodass sie nicht vom Clientrechteck und dem Kontext des Renderinggeräts abhängen.

Ansichtseinsätze können auf beiden Seiten des Clientrechtecks negativ sein, was zu einem größeren Sichtrechteck als dem Clientrechteck führt. Der Text sollte dann an das Clientrechteck gekappt werden. Wenn das Ansichtsrechteck breiter als das Clientrechteck ist, kann der Host dem Steuerelement eine horizontale Bildlaufleiste hinzufügen.

Einzeilige Textdiensteobjekte ignorieren beim Formatieren von Text die rechte Begrenzung des Sichtrechtecks.

Der Sichteinset ist vom Host jederzeit verfügbar, aktiv oder inaktiv.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
DLL	Msftedit.dll

Weitere Informationen

ITextHost

Übersicht über fensterlose Rich-Edit-Steuerelemente