TEXT.wordWrap

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

wordWrap 属性指定或检索一个值，该值指示是启用或禁用自动换行。

        elementID.wordWrap

可能的值

此属性是读/写 Boolean 类型的值。

值 说明
是 启用Word包装。
false 默认。 禁用Word换行。 如果文本不适合控件中，则会裁剪文本。

备注

Text 控件不会将单词拆分。 如果单词超出控件的宽度，则采用自动换行将单词移动到下一行。 如果单个单词长于控件宽度，则会剪裁该单词并占用一行。

如果未指定 width 属性，则忽略 wordWrap ，并且 Text 控件将调整大小，而不是环绕文本。

如果需要在特定位置使用换行符，则必须使用“#13;”或“&\r”在值中显式指定换行符。 如果在直接指定值时使用后一种形式，则字符串的前缀必须为“JScript：”，并且实际值必须用单引号括起来，如下所示。 如果值是从事件处理程序中动态设置的，则不需要这样做。

如果 wordWrap 设置为 true 且未指定 工具提示 ，则工具提示将显示 值 属性的全文。 如果不需要工具提示，请将 工具提示 设置为“” (空字符串) 。

示例

<THEME>
  <VIEW>
    <TEXT
      width = "50"
      height = "200"
      wordWrap = "true"
      backgroundColor = "blue"
      foregroundColor = "white"
      value = "This is a test.&#13;&#13;It is only a test."
    />
    <TEXT
      width = "50"
      height = "200"
      left = "100"
      wordWrap = "true"
      backgroundColor = "green"
      foregroundColor = "white"
      value = "JScript:'This is a test.\r\rIt is only a test.'"
    />
  </VIEW>
</THEME>

要求

要求 值
版本
 Windows 媒体播放器版本 7.0 或更高版本

另请参阅

AmbientAttributes.width

TEXT 元素

TEXT.toolTip

TEXT.value