name_ascii property

Font.name_ascii property

Returns or sets the font used for Latin text (characters with character codes from 0 (zero) through 127).

@property
def name_ascii(self) -> str:
    ...

@name_ascii.setter
def name_ascii(self, value: str):
    ...

Examples

Shows how Microsoft Word can combine two different fonts in one run.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Suppose a run that we use the builder to insert while using this font configuration
# contains characters within the ASCII characters' range. In that case,
# it will display those characters using this font.
builder.font.name_ascii = 'Calibri'
# With no other font specified, the builder will also apply this font to all characters that it inserts.
self.assertEqual('Calibri', builder.font.name)
# Specify a font to use for all characters outside of the ASCII range.
# Ideally, this font should have a glyph for each required non-ASCII character code.
builder.font.name_other = 'Courier New'
# Insert a run with one word consisting of ASCII characters, and one word with all characters outside that range.
# Each character will be displayed using either of the fonts, depending on.
builder.writeln('Hello, Привет')
doc.save(file_name=ARTIFACTS_DIR + 'Font.NameAscii.docx')

See Also

Font.name property Font.name_bi property