Contents
Navigation
Home User Reference Other Resources


The TextDescription QuickTime structure contains informations that describe text samples data.

The QTPlgTextDesc class provides you with properties and methods that let you whether access or create new instances of such a QuickTime description structure. Also, you can use instances of this class as a convenient container for text settings that you will use in any way you like it.







The QTPlgTextDesc class constructors are called when you create a new instance of the class, while the ˜QTPlgTextDesc class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.
Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. See the validity requirements for more details.

The class provides you with the following initializer methods:
()
This is the default constructor. Use this constructor to create a completely new data descriptor container in memory. The class property is set to 0
(other as QTPlgTextDesc)
This is the copy constructor. The properties of the object to be copied will be used to initialize the new class instance properties

returns the handle to the text description structure in use. useful for toolbox programmers (use with care: you could invalidate the handle causing unpredictable results (probably an application crash))
indicates the location of the text within
indicates the delay in scrolling associated with the setting of the and class properties. If the value of this property is greater than 0 and the property is true, the text pauses when it has scrolled all the way in for the amount of time specified by this property. If the property is true, the pause occurs first before the text scrolls out. If both these properties are true, the pause occurs at the midpoint between scrolling in and scrolling out
determines if the specified sample is to be displayed
clips to just the . This is useful if the text overlays the video
scrolls the text in until the last of the text is in view. This property works together with the class property
scrolls text out until the last of the text is out of view. This property works together with the class property. If both and this property are set to true, the text is scrolled in, then out
scrolls a single line of text horizontally. If this property is false, then the scrolling is vertical
determines if to scroll vertically down, rather than up. If this property is set to false, horizontal scrolling proceeds toward the left rather than toward the right
determines if the text media handler lets new samples cause previous samples to scroll out. You must also set to true either the or the class properties, or both, for this to take effect
determines if the text media handler ignores the starting offset when highlighting text. If this property is set to false, the text media handler highlights text from the beginning of the text sample to the ending offset
determines if the text is to be displayed with a drop shadow
determines if the text is to be displayed with anti–aliasing. Note that although anti–aliased text looks smoother, anti–aliasing can slow down performance
specifies how the text is to be aligned; you can use one of the defined by the class
specifies the font family ID
specifies the font size in points
specifies the name of the default font
specifies the background color for the text display
specifies the text color
establishes the plain text style for the text display
establishes the bold text style for the text display
establishes the italic text style for the text display
establishes the underline text style for the text display


default alignment according to the primary line direction
center for all scripts
right alignment for all scripts
left alignment for all scripts