FrameFormat class

FrameFormat class

Represents frame related formatting for a paragraph.

Remarks

This object is always created. If a paragraph is a frame, then all properties will contain respective values, otherwise all properties are set to their defaults.

Use FrameFormat.is_frame to check whether paragraph is a frame.

Properties

NameDescription
heightGets the height of the specified frame.
height_ruleGets the rule for determining the height of the specified frame.
horizontal_alignmentGets horizontal alignment of the specified frame.
horizontal_distance_from_textGets horizontal distance between a frame and the surrounding text, in points.
horizontal_positionGets horizontal distance between the edge of the frame and the item specified by the FrameFormat.relative_horizontal_position property.
is_frameReturns True if the paragraph is a frame.
relative_horizontal_positionGets the relative horizontal position of a frame.
relative_vertical_positionGets the relative vertical position of a frame.
vertical_alignmentGets vertical alignment of the specified frame.
vertical_distance_from_textSpecifies vertical distance (in points) between a frame and the surrounding text.
vertical_positionGets vertical distance between the edge of the frame and the item specified by the FrameFormat.relative_vertical_position property.
widthGets the width of the specified frame, in points.

Examples

Shows how to get information about formatting properties of paragraphs that are frames.

doc = aw.Document(MY_DIR + 'Paragraph frame.docx')
for paragraph in doc.first_section.body.paragraphs:
    paragraph = paragraph.as_paragraph()
    if paragraph.frame_format.is_frame:
        paragraph_frame = paragraph
        break
self.assertEqual(233.3, paragraph_frame.frame_format.width)
self.assertEqual(138.8, paragraph_frame.frame_format.height)
self.assertEqual(aw.HeightRule.AT_LEAST, paragraph_frame.frame_format.height_rule)
self.assertEqual(aw.drawing.HorizontalAlignment.DEFAULT, paragraph_frame.frame_format.horizontal_alignment)
self.assertEqual(aw.drawing.VerticalAlignment.DEFAULT, paragraph_frame.frame_format.vertical_alignment)
self.assertEqual(34.05, paragraph_frame.frame_format.horizontal_position)
self.assertEqual(aw.drawing.RelativeHorizontalPosition.PAGE, paragraph_frame.frame_format.relative_horizontal_position)
self.assertEqual(9.0, paragraph_frame.frame_format.horizontal_distance_from_text)
self.assertEqual(20.5, paragraph_frame.frame_format.vertical_position)
self.assertEqual(aw.drawing.RelativeVerticalPosition.PARAGRAPH, paragraph_frame.frame_format.relative_vertical_position)
self.assertEqual(0.0, paragraph_frame.frame_format.vertical_distance_from_text)

See Also