textout

  name="google_ads_frame" marginwidth="0" marginheight="0" src="http://pagead2.googlesyndication.com/pagead/ads?client=ca-pub-5572165936844014&dt=1193665761703&lmt=1193665780&format=336x280_as&output=html&correlator=1193665761687&url=http%3A%2F%2Fwww.codeguru.cn%2Fpublic%2Fiframe%2Fwinapiiframe.htm&color_bg=FFFFFF&color_text=000000&color_link=000000&color_url=FFFFFF&color_border=FFFFFF&ad_type=text&ga_vid=1285758818.1193665762&ga_sid=1193665762&ga_hid=111695597&flash=9&u_h=768&u_w=1024&u_ah=740&u_aw=1024&u_cd=32&u_tz=480&u_his=8&u_java=true" frameborder="0" width="336" scrolling="no" height="280" allowtransparency="allowtransparency">     函数功能：该函数用当前选择字符、背景颜色和正文颜色将一个字符串写到指定位置。

    函数原型：BOOL TextOut (HDC hdc, int nXStart, int nYStart, LPCTSTR lpString, int cbString)；

    参数：

    hdc：设备环境句柄。

    nXStart：指定用于字符串对齐的基准点的逻辑X坐标。

    nYStart：指定用于字符串对齐的基准点的逻辑Y坐标。

    lpString：指向将被绘制字符串的指针。此字符串不必为以/0结束的，因为cbString中指定了字符串的长度。

    cbString：字符串的字符数。

    返回值：如果函数调用成功，返回值非零；如果函数调用失败，返回值是0。

    Windows NT：若想获得更多错误信息，请调用GetLastError函数。

    备注：对基准点的解释依赖于当前字符对齐模式，一个应用程序可以调用GetTextAlign来获得该模式，调用SetTextAlign来更改该模式。

    缺省地，此函数不能使用和修改当前位置，但一个应用程序可以在每次在指定设备环境中调用TextOut之前，通过将参数fMode设为TA_UPDATECP值来调用SetTextAlign，以允许系统在调用TextOut时修改当前位置，当上述标志设置时，系统会忽略随后调用TextOut中的nXStart和nYStart值。

    当把函数TextOut放入一个路径括号内时，系统为包含每一个字符并加上字符值的TrueType正文产生一个路径，产生的区域是字符框加上正文，而不是正文本身，可以在把TextOut放入路径括号之前设置背景模式为透明的，这样就能得到由TrueType正文的轮廓封闭而成的区域。下面是说明这个过程的例程代码：

    GetClientRect(hwnd, &r); BeginPath(hdc); TextOut(hdc, r.left, r.top, "Defenestration can be hazardous", 4); EndPath(hdc); SelectClipPath(hdc, RGN_AND); FillRect(hdc, &r, GetStockObject(GRAY_BRUSH))。

    速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib；Unicode：在Windows NT环境下实现为Unicode和ANSI两种版本。