Edit

Share via

IAgentBalloonEx::SetNumLines

  • Article

[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]

HRESULT SetNumLines(
   long lLines,  // number of lines setting
);

Sets the number of lines of text output that can be displayed in the character's word balloon.

  • Returns S_OK to indicate the operation was successful.
  • Returns E_INVALIDARG if the parameter is zero.

lLines

Number of lines to display in the word balloon.

The minimum setting is 1 and maximum is 128. If the text specified in the Speak or Think method exceeds the size of the current balloon, Agent automatically scrolls the text in the balloon.

This method will fail if the SizeToText balloon style bit is set.

The default setting is based on settings when the character is compiled with the Microsoft Agent Character Editor.

See Also

IAgentBalloon::GetNumLines, IAgentBalloonEx::GetStyle, IAgentBalloonEx::SetStyle