DrawText()

Syntax

Ergebnis = DrawText(x, y, Text$ [, VordergrundFarbe [, HintergrundFarbe]])

Stellt den angegebenen String auf dem aktuellen Ausgabekanal an der angegebenen (x,y) Position dar. Der aktuelle Ausgabekanal wird mittels StartDrawing() definiert.

Parameter

x, y	Die Position, an welcher der Text gezeichnet werden soll.
Text$	Der zu zeichnende Text.
VordergrundFarbe (optional)	Die für den Text zu verwendende Farbe. Wenn dieser Parameter nicht angegeben wird, dann wird die mit FrontColor() festgelegte Standardfarbe verwendet. Diese Farbe kann im RGB- oder RGBA-Format vorliegen.
HintergrundFarbe (optional)	Die für den Hintergrund zu verwendende Farbe. Wenn dieser Parameter nicht angegeben wird, dann wird die mit BackColor() festgelegte Standardfarbe verwendet. Wenn der aktuelle Zeichmodus (DrawingMode()) den #PB_2DDrawing_Transparent Flag beinhaltet, dann wird dieser Parameter ignoriert und der Hintergrund ist transparent.

Rückgabewert

Gibt die neue x-Position des Text-Cursors zurück (d.h. die Position direkt nach dem gezeichneten Text).

Anmerkungen

Wenn DrawingMode() auf nicht transparenten Hintergrund gesetzt ist und der aktuelle Zeichenmodus (DrawingMode) den Alpha-Kanal verwendet, dann wird der Text zuerst auf den Hintergrund gemischt und dann auf den Ausgabekanal angewandt.

Beispiel

  If OpenWindow(0, 0, 0, 200, 200, "2DDrawing Beispiel", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateImage(0, 200, 200) And StartDrawing(ImageOutput(0))
      DrawingMode(#PB_2DDrawing_Transparent)
      Box(0, 0, 200, 200, RGB(255, 255, 255))
      For i = 1 To 30
        DrawText(Random(200), Random(200), "Hello World!", RGB(Random(255), Random(255), Random(255)))
      Next i
      StopDrawing() 
      ImageGadget(0, 0, 0, 200, 200, ImageID(0))
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

DrawRotatedText(), DrawingFont(), FrontColor(), BackColor()

Unterstützte OS

Alle