Class FontCollection
Represents a collection of font families.
Inherited Members
Namespace: SixLabors.Fonts
Assembly: SixLabors.Fonts.dll
Syntax
public sealed class FontCollection : IFontCollection, IReadOnlyFontCollectionConstructors
| Improve this Doc View SourceFontCollection()
Initializes a new instance of the FontCollection class.
Declaration
public FontCollection()Properties
| Improve this Doc View SourceFamilies
Gets the collection of FontFamily in this IReadOnlyFontCollection using the invariant culture.
Declaration
public IEnumerable<FontFamily> Families { get; }Property Value
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | 
Methods
| Improve this Doc View SourceAdd(Stream)
Adds a font to the collection.
Declaration
public FontFamily Add(Stream stream)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(Stream, out FontDescription)
Adds a font to the collection.
Declaration
public FontFamily Add(Stream stream, out FontDescription description)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| FontDescription | description | The description of the added font. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(Stream, CultureInfo)
Adds a font to the collection.
Declaration
public FontFamily Add(Stream stream, CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| CultureInfo | culture | The culture of the font to add. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(Stream, CultureInfo, out FontDescription)
Adds a font to the collection.
Declaration
public FontFamily Add(Stream stream, CultureInfo culture, out FontDescription description)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| CultureInfo | culture | The culture of the font to add. | 
| FontDescription | description | The description of the added font. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(String)
Adds a font to the collection.
Declaration
public FontFamily Add(string path)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The filesystem path to the font file. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(String, out FontDescription)
Adds a font to the collection.
Declaration
public FontFamily Add(string path, out FontDescription description)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The filesystem path to the font file. | 
| FontDescription | description | The description of the added font. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(String, CultureInfo)
Adds a font to the collection.
Declaration
public FontFamily Add(string path, CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The filesystem path to the font file. | 
| CultureInfo | culture | The culture of the font to add. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
Add(String, CultureInfo, out FontDescription)
Adds a font to the collection.
Declaration
public FontFamily Add(string path, CultureInfo culture, out FontDescription description)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The filesystem path to the font file. | 
| CultureInfo | culture | The culture of the font to add. | 
| FontDescription | description | The description of the added font. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The new FontFamily. | 
AddCollection(Stream)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(Stream stream)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(Stream, out IEnumerable<FontDescription>)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(Stream stream, out IEnumerable<FontDescription> descriptions)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| IEnumerable<FontDescription> | descriptions | The descriptions of the added fonts. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(Stream, CultureInfo)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(Stream stream, CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| CultureInfo | culture | The culture of the fonts to add. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(Stream, CultureInfo, out IEnumerable<FontDescription>)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(Stream stream, CultureInfo culture, out IEnumerable<FontDescription> descriptions)Parameters
| Type | Name | Description | 
|---|---|---|
| Stream | stream | The font stream. | 
| CultureInfo | culture | The culture of the fonts to add. | 
| IEnumerable<FontDescription> | descriptions | The descriptions of the added fonts. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(String)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(string path)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The font collection path. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(String, out IEnumerable<FontDescription>)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(string path, out IEnumerable<FontDescription> descriptions)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The font collection path. | 
| IEnumerable<FontDescription> | descriptions | The descriptions of the added fonts. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(String, CultureInfo)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(string path, CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The font collection path. | 
| CultureInfo | culture | The culture of the fonts to add. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
AddCollection(String, CultureInfo, out IEnumerable<FontDescription>)
Adds a true type font collection (.ttc).
Declaration
public IEnumerable<FontFamily> AddCollection(string path, CultureInfo culture, out IEnumerable<FontDescription> descriptions)Parameters
| Type | Name | Description | 
|---|---|---|
| String | path | The font collection path. | 
| CultureInfo | culture | The culture of the fonts to add. | 
| IEnumerable<FontDescription> | descriptions | The descriptions of the added fonts. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The new IEnumerable<T>. | 
Get(String)
Gets the specified font family matching the invariant culture and font family name.
Declaration
public FontFamily Get(string name)Parameters
| Type | Name | Description | 
|---|---|---|
| String | name | The font family name. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The first FontFamily matching the given name. | 
Exceptions
| Type | Condition | 
|---|---|
| ArgumentNullException | 
 | 
| FontFamilyNotFoundException | The collection contains no matches. | 
Get(String, CultureInfo)
Gets the specified font family matching the given culture and font family name.
Declaration
public FontFamily Get(string name, CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| String | name | The font family name. | 
| CultureInfo | culture | The culture to use when searching for a match. | 
Returns
| Type | Description | 
|---|---|
| FontFamily | The first FontFamily matching the given name. | 
Exceptions
| Type | Condition | 
|---|---|
| ArgumentNullException | 
 | 
| FontFamilyNotFoundException | The collection contains no matches. | 
GetByCulture(CultureInfo)
Gets the collection of FontFamily in this FontCollection using the given culture.
Declaration
public IEnumerable<FontFamily> GetByCulture(CultureInfo culture)Parameters
| Type | Name | Description | 
|---|---|---|
| CultureInfo | culture | The culture of the families to return. | 
Returns
| Type | Description | 
|---|---|
| IEnumerable<FontFamily> | The IEnumerable<T>. | 
TryGet(String, out FontFamily)
Gets the specified font family matching the invariant culture and font family name.
Declaration
public bool TryGet(string name, out FontFamily family)Parameters
| Type | Name | Description | 
|---|---|---|
| String | name | The font family name. | 
| FontFamily | family | When this method returns, contains the family associated with the specified name, if the name is found; otherwise, the default value for the type of the family parameter. This parameter is passed uninitialized. | 
Returns
| Type | Description | 
|---|---|
| Boolean | true if the IReadOnlyFontCollection contains a family with the specified name; otherwise, false. | 
Exceptions
| Type | Condition | 
|---|---|
| ArgumentNullException | 
 | 
TryGet(String, CultureInfo, out FontFamily)
Gets the specified font family matching the given culture and font family name.
Declaration
public bool TryGet(string name, CultureInfo culture, out FontFamily family)Parameters
| Type | Name | Description | 
|---|---|---|
| String | name | The font family name. | 
| CultureInfo | culture | The culture to use when searching for a match. | 
| FontFamily | family | When this method returns, contains the family associated with the specified name, if the name is found; otherwise, the default value for the type of the family parameter. This parameter is passed uninitialized. | 
Returns
| Type | Description | 
|---|---|
| Boolean | true if the IReadOnlyFontCollection contains a family with the specified name; otherwise, false. | 
Exceptions
| Type | Condition | 
|---|---|
| ArgumentNullException | 
 |