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 |