Share via


GDI Plus StringFormat Foundation Class

The gpStringFormat class provides an object encapsulating text layout information (such as alignment and line spacing) and display manipulations (such as ellipsis insertion and national digit substitution).

Category Reporting

Default Catalog

Visual FoxPro Catalog\Foundation Classes\Output\GDIplus

Class

gpStringFormat

Base Class

Custom

Class Library

_GDIPLUS.vcx

Parent Class

gpObject (GDI Plus Object Foundation Class)

Remarks

The following table lists public properties and methods added by this class to its parent class, gpObject. This class also implements the Clone and Init methods.

Properties and methods Description

Alignment Property

Text horizontal alignment specified using values indicated by GDIPLUS_STRINGALIGNMENT_* constants.

Default:GDIPLUS_STRINGALIGNMENT_Near.

Remarks: In a left-to-right reading order environment, GDIPLUS_STRINGALIGNMENT_Near is equivalent to "left alignment," and GDIPLUS_STRINGALIGNMENT_Far is equivalent to "right alignment."

Clone Method

Clones a StringFormat object.

Syntax: ? THIS.Clone(toGpStringFormat)

Return Values: Logical, representing success or failure.

Parameters: 

toGpStringFormat, required, the gpStringFormat-based object to clone.

Create Method

Creates a StringFormat object with optional flags and language information.

Syntax: THIS.Create([tnFlags[, tnLangID]])

Return Values: Logical, representing success or failure.

Parameters: 

tnFlags, optional, initial value for the FormatFlags property.

tnLangID, optional, an integer language identifier.

FormatFlags Property

String formatting flags specified using a combination of bit values, using values defined by GDIPLUS_STRINGFORMATFLAGS_* constants.

Default: Empty.

GetGenericDefault Method

Constructs a StringFormat object equivalent to .NET's System.Drawing.StringFormat.GenericDefault.

Syntax:THIS.GetGenericDefault(tlMakeClone)

Return Values: Logical, representing success or failure.

Remarks: Upon successful return from this method the object represents a system standard string format, and all properties become read-only.

GetGenericTypographic Method

Constructs a StringFormat object with Generic Typographic properties set as they would be by .NET's System.Drawing.StringFormat. GenericTypographic.

Syntax:THIS.GetGenericTypographic(tlMakeClone)

Return Values: Logical, representing success or failure.

Remarks: Upon successful return from this method the object represents a system standard string format, and all properties become read-only.

HotkeyPrefix Property

HotkeyPrefix setting with values indicated by GDIPLUS_HOTKEYPREFIX_* constants.

Init Method

Constructs a StringFormat object during initialization if passed appropriate arguments.

Syntax: CREATEOBJECT("gpStringFormat" [, tnFlags[, tnLangID]])

Return Values: Logical, representing success or failure. If the method fails, the object does not instantiate.

Parameters: 

tnFlags, optional, initial value for the FormatFlags property.

tnLangID, optional, an integer language identifier.

LineAlignment Property

Text line vertical alignment specified using values indicated by GDIPLUS_STRINGALIGNMENT_* constants.

Default:GDIPLUS_STRINGALIGNMENT_Near.

Remarks: In a top-to-bottom reading order environment, GDIPLUS_STRINGALIGNMENT_Near is equivalent to "top alignment," and GDIPLUS_STRINGALIGNMENT_Far is equivalent to "bottom alignment."

Trimming Property

Flags that specify how text is trimmed when it overflows the layout rectangle, using values indicated by GDIPLUS_STRINGTRIMMING_* constants.

Default:GDIPLUS_STRINGTRIMMING_None.

See Also

Reference

Visual FoxPro Foundation Classes A-Z
GDI Plus API Wrapper Foundation Classes

Concepts

Guidelines for Using Visual FoxPro Foundation Classes