Freigeben über

ITextRange2::InsertImage-Methode (tom.h)

Fügt ein Bild in diesen Bereich ein.

Syntax

HRESULT InsertImage(
  [in] long    width,
  [in] long    height,
  [in] long    ascent,
  [in] long    Type,
  [in] BSTR    bstrAltText,
  [in] IStream *pStream
);

Parameter

[in] width

Typ: long

Die Breite des Bilds in HIMETRIC-Einheiten (0,01 mm).

[in] height

Typ: long

Die Höhe des Bilds in HIMETRIC-Einheiten.

[in] ascent

Typ: long

Wenn Type TA_BASELINE ist, ist dieser Parameter der Abstand in HIMETRIC-Einheiten, den sich der obere Rand des Bilds über die Textbasislinie erstreckt. Wenn Type TA_BASELINE und Aufstieg null ist, wird der untere Rand des Bilds an der Textbasislinie platziert.

[in] Type

Typ: long

Die vertikale Ausrichtung des Bilds. Dieses Argument einen der folgenden Werte annehmen.

Wert Bedeutung
TA_BASELINE
 Richten Sie das Bild relativ zur Textbasislinie aus.
TA_BOTTOM
 Richten Sie den unteren Rand des Bilds am unteren Rand der Textzeile aus.
TA_TOP
 Am oberen Rand des Bilds am oberen Rand der Textzeile ausrichten

[in] bstrAltText

Typ: BSTR

Der alternative Text für das Bild.

[in] pStream

Typ: IStream

Der Stream, der die Bilddaten enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der Bereich nicht degeneriert ist, ersetzt das Bild den Text im Bereich.

Anforderungen

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

Weitere Informationen

ITextRange2

  • Last updated on