~ZicSrSSKJr SSKJrJrJr SSKJr SSK J r SSK J r SSK JrJrJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJrJrJrJ r J!r! \(a,SSK"J#r# SSK J$r$JrJ%r% SSK&J'r' SSK(J)r)J*r*J+r+J,r,J-r- SSK.J/r/J0r0 "SS\5r1"SS\25r3"SS\5r4"SS\5r5"SS\5r6g)z5Text-related objects such as TextFrame and Paragraph.) annotations) TYPE_CHECKINGIteratorcast) FillFormat)MSO_FILL)MSO_LANGUAGE_ID) MSO_AUTO_SIZE MSO_UNDERLINEMSO_VERTICAL_ANCHOR)RELATIONSHIP_TYPE)ST_TextWrappingType)Subshape) FontFiles) TextFitter) CentipointsEmuLengthPt lazyproperty) ColorFormat)MSO_TEXT_UNDERLINE_TYPEr PP_PARAGRAPH_ALIGNMENT) CT_Hyperlink)CT_RegularTextRun CT_TextBodyCT_TextCharacterPropertiesCT_TextParagraphCT_TextParagraphProperties)ProvidesExtents ProvidesPartc^\rSrSrSrSU4SjjrSr\SSj5r\RS Sj5rSr S!S"Sjjr \S#S j5r \ RS$S j5r \S#S j5r \ RS$S j5r \S#S j5r\RS$Sj5r\S#Sj5r\RS$Sj5r\S%Sj5r\S&Sj5r\RS'Sj5r\S(Sj5r\RS)Sj5r\S*Sj5r\RS+Sj5rS,SjrS-Sjr\S5r\S.Sj5rS/SjrSrU=r$)0 TextFrame$zThe part of a shape that contains its text. Not all shapes have a text frame. Corresponds to the `p:txBody` element that can appear as a child element of `p:sp`. Not intended to be constructed directly. cT>[[U] U5 U=UlUlX lgN)superr#__init___element_txBody_parent)selftxBodyparent __class__s h/var/www/eduai.edurigo.com/question_generate/ques_gen_env/lib/python3.13/site-packages/pptx/text/text.pyr(TextFrame.__init__+s% i'/'--   cLURR5n[X5$)zg Return new |_Paragraph| instance appended to the sequence of paragraphs contained in this text frame. )r*add_p _Paragraphr,ps r0 add_paragraphTextFrame.add_paragraph0s! LL   !""r2c.URR$)aKResizing strategy used to fit text within this shape. Determins the type of automatic resizing used to fit the text of this shape within its bounding box when the text would otherwise extend beyond the shape boundaries. May be |None|, `MSO_AUTO_SIZE.NONE`, `MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT`, or `MSO_AUTO_SIZE.TEXT_TO_FIT_SHAPE`. _bodyPrautofitr,s r0 auto_sizeTextFrame.auto_size8s||###r2c$XRlgr&r;r,values r0r?r@Cs $ r2cURRSSHnURRU5 M URSnUR 5 g)z+Remove all paragraphs except one empty one.Nr)r*p_lstremove paragraphsclearr6s r0rITextFrame.clearGsF##AB'A LL   "( OOA   r2cpURS:XagURXX4U5nURXX45 g)aFit text-frame text entirely within bounds of its shape. Make the text in this text frame fit entirely within the bounds of its shape by setting word wrap on and applying the "best-fit" font size to all the text it contains. :attr:`TextFrame.auto_size` is set to :attr:`MSO_AUTO_SIZE.NONE`. The font size will not be set larger than `max_size` points. If the path to a matching TrueType font is provided as `font_file`, that font file will be used for the font metrics. If `font_file` is |None|, best efforts are made to locate a font file with matchhing `font_family`, `bold`, and `italic` installed on the current system (usually succeeds if the font is installed). N)text_best_fit_font_size _apply_fit)r, font_familymax_sizebolditalic font_file font_sizes r0fit_textTextFrame.fit_textNs5( 99? ,,[DR[\   =r2c.URR$)z|Length| value representing the inset of text from the bottom text frame border. :meth:`pptx.util.Inches` provides a convenient way of setting the value, e.g. `text_frame.margin_bottom = Inches(0.05)`. r<bInsr>s r0 margin_bottomTextFrame.margin_bottomhs||   r2c$XRlgr&rYr,emus r0r[r\q  r2c.URR$)zs r0 margin_leftTextFrame.margin_leftu||   r2c$XRlgr&rbr^s r0rdrezr`r2c.URR$)z=Inset of text from right text frame border as |Length| value.r<rInsr>s r0 margin_rightTextFrame.margin_right~rfr2c$XRlgr&rir^s r0rkrlr`r2c.URR$)z;Inset of text from top text frame border as |Length| value.r<tInsr>s r0 margin_topTextFrame.margin_toprfr2c$XRlgr&ror^s r0rqrrr`r2c ~[URRVs/sHn[X5PM sn5$s snf)zaSequence of paragraphs in this text frame. A text frame always contains at least one paragraph. )tupler*rFr5r6s r0rHTextFrame.paragraphss2 4<<3E3EF3Eaj)3EFGGFs:cFSRSUR55$)aAll text in this text-frame as a single string. Read/write. The return value contains all text in this text-frame. A line-feed character (`"\n"`) separates the text for each paragraph. A vertical-tab character (`"\v"`) appears for each line break (aka. soft carriage-return) encountered. The vertical-tab character is how PowerPoint represents a soft carriage return in clipboard text, which is why that encoding was chosen. Assignment replaces all text in the text frame. A new paragraph is added for each line-feed character (`"\n"`) encountered. A line-break (soft carriage-return) is inserted for each vertical-tab character (`"\v"`) encountered. Any control character other than newline, tab, or vertical-tab are escaped as plain-text like "_x001B_" (for ESC (ASCII 32) in this example).  c38# UHoRv M g7fr&rM).0 paragraphs r0 !TextFrame.text..sII)joinrHr>s r0rMTextFrame.texts$yyIIIIr2cURnUR5 URS5H$nUR5nUR U5 M& g)Nrx)r* clear_contentsplitr4 append_text)r,rMr-p_textr7s r0rMrsAjj&F A MM& !'r2cBURRR$)zRepresents the vertical alignment of text in this text frame. |None| indicates the effective value should be inherited from this object's style hierarchy. r*bodyPranchorr>s r0vertical_anchorTextFrame.vertical_anchors ||"")))r2c<URRnXlgr&r)r,rCrs r0rrs$$ r2c[RS[RSSS0URRR $)aZ`True` when lines of text in this shape are wrapped to fit within the shape's width. Read-write. Valid values are True, False, or None. True and False turn word wrap on and off, respectively. Assigning None to word wrap causes any word wrap setting to be removed from the text frame, causing it to inherit this setting from its style hierarchy. TFN)rSQUARENONEr*rwrapr>s r0 word_wrapTextFrame.word_wrapsC & &  $ $e $  ,,   " " $ $r2cUS;a[SU-5e[R[RSS.UURR lg)N)TFNz3assigned value must be True, False, or None, got %s) ValueErrorrrrr*rrrBs r0rrsU + +EM &,,&++$   $  r2c`[RUlSUlUR XX45 g)zArrange text in this text frame to fit inside its extents. This is accomplished by setting auto size off, wrap on, and setting the font of all its text to `font_family`, `font_size`, `is_bold`, and `is_italic`. TN)r rr?r _set_font)r,rPrUis_bold is_italics r0rOTextFrame._apply_fits& '++ {wBr2cUc[R"XU5n[R"URUR X%5$)aReturn font-size in points that best fits text in this text-frame. The best-fit font size is the largest integer point size not greater than `max_size` that allows all the text in this text frame to fit inside its extents when rendered using the font described by `family`, `bold`, and `italic`. If `font_file` is specified, it is used to calculate the fit, whether or not it matches `family`, `bold`, and `italic`. )rfindrbest_fit_font_sizerM_extents)r,familyrQrRrSrTs r0rNTextFrame._best_fit_font_sizes7  !vVs r0r<TextFrame._bodyPrs||"""r2c[SUR5n[URUR- UR - 5[UR UR- UR- 54$)zp(cx, cy) 2-tuple representing the effective rendering area of this text-frame. Margins are taken into account. r ) rr+rwidthrdrkheightrqr[)r,r.s r0rTextFrame._extentssa '6 6<<$"2"22T5F5FF G 6==4??2T5G5GG H  r2c^SSjnSU4SjjnURnU"U5HnU"UTX#U5 M g)z;Set the font properties of all the text in this text frame.c3# URH:nURHnUR5v M UR5v M< g7fr&)rFcontent_childrenget_or_add_rPrget_or_add_endParaRPr)r-r7elms r0 iter_rPrs&TextFrame._set_font..iter_rPrssC\\--C,,...--// "sA Acj>[U5nT[U5X44uUlUlUlUlgr&)FontrnamesizerRrS)rPrrrrRrSfrs r0 set_rPr_font)TextFrame._set_font..set_rPr_font s/S A/5r$x/M ,AFAFAFAHr2N)r-rreturnz$Iterator[CT_TextCharacterProperties]) rrrstrrintrRboolrSr)r)) r,rrrRrSrrr-rs ` r0rTextFrame._set_fontsc 0 N+ N36 N>A NIM NW[ N V$C fd& 9%r2)r)r+r*r?r)r-rr.r!)rMSO_AUTO_SIZE | None)rCr)CalibriFFN) rPrrQrrRrrSrrT str | None)rr)r_r)rztuple[_Paragraph, ...]rrrMr)rMSO_VERTICAL_ANCHOR | None)rCrr bool | NonerCr)rPrrUrrrrr) rrrQrrRrrSrrTrrr)rztuple[Length, Length])rrrrrRrrSr)__name__ __module__ __qualname____firstlineno____doc__r(r8propertyr?setterrIrVr[rdrkrqrHrMrrrOrNr<rr__static_attributes__ __classcell__r/s@r0r#r#$sW  #$$%%% $ >>> >  >  >4!!  !!  !!  !!  HHJJ& [[""** $ $  C \ \%( \04 \>B \OY \  \##    ::r2r#c^\rSrSrSrSU4Sjjr\SSj5r\RSSj5r\ SSj5r \ SSj5r \SSj5r \ RSS j5r \SS j5r \ RSS j5r \SS j5r\RSS j5r\SSj5r\RSSj5r\SSj5r\RSSj5rSrU=r$) rizCharacter properties object, providing font size, font name, bold, italic, etc. Corresponds to `a:rPr` child element of a run. Also appears as `a:defRPr` and `a:endParaRPr` in paragraph and `a:defRPr` in list style elements. cF>[[U] 5 U=UlUlgr&)r'rr(r)_rPr)r,rr/s r0r( Font.__init__s dD"$$''  r2c.URR$)aJGet or set boolean bold value of |Font|, e.g. `paragraph.font.bold = True`. If set to |None|, the bold setting is cleared and is inherited from an enclosing shape's setting, or a setting in a style or master. Returns None if no bold attribute is present, meaning the effective bold value is inherited from a master or the theme. rbr>s r0rR Font.bold#syy{{r2c$XRlgr&rrBs r0rRr-  r2cURR[R:waURR 5 URR $)zTThe |ColorFormat| instance that provides access to the color settings for this font.)filltyperSOLIDsolid fore_colorr>s r0color Font.color1s6 99>>X^^ + IIOO yy###r2cB[R"UR5$)z]|FillFormat| instance for this font. Provides access to fill properties such as fill color. )rfrom_fill_parentrr>s r0r Font.fill8s **49955r2c.URR$)zqGet or set boolean italic value of |Font| instance. Has the same behaviors as bold with respect to None values. rir>s r0rS Font.italic@s yy{{r2c$XRlgr&rrBs r0rSrHrr2cURRnUc[R$URR$)zGet or set the language id of this |Font| instance. The language id is a member of the :ref:`MsoLanguageId` enumeration. Assigning |None| removes any language setting, the same behavior as assigning `MSO_LANGUAGE_ID.NONE`. )rlangr r)r,rs r0 language_idFont.language_idLs0yy~~ <"'' 'yy~~r2cPU[R:XaSnXRlgr&)r rrrrBs r0rrXs O(( (E r2cNURRnUcgUR$)aGet or set the typeface name for this |Font| instance. Causes the text it controls to appear in the named font, if a matching font is found. Returns |None| if the typeface is currently inherited from the theme. Setting it to |None| removes any override of the theme typeface. N)rlatintypeface)r,rs r0r Font.name^s#  =~~r2cUcURR5 gURR5nXlgr&)r _remove_latinget_or_add_latinr)r,rCrs r0rrks. = II # # %II..0E"Nr2cLURRnUcg[U5$)aIndicates the font height in English Metric Units (EMU). Read/write. |None| indicates the font size should be inherited from its style hierarchy, such as a placeholder or document defaults (usually 18pt). |Length| is a subclass of |int| having properties for convenient conversion into points or other length units. Likewise, the :class:`pptx.util.Pt` class allows convenient specification of point values:: >>> font.size = Pt(24) >>> font.size 304800 >>> font.size.pt 24.0 N)rszr)r,rs r0r Font.sizess#YY\\ :2r2cxUcSURlg[U5RnX Rlgr&)rrr centipoints)r,r_rs r0rrs* ;DIILS%%BIILr2cURRnU[RLagU[RLagU$)aIndicaties the underline setting for this font. Value is |True|, |False|, |None|, or a member of the :ref:`MsoTextUnderlineType` enumeration. |None| is the default and indicates the underline setting should be inherited from the style hierarchy, such as from a placeholder. |True| indicates single underline. |False| indicates no underline. Other settings such as double and wavy underlining are indicated with members of the :ref:`MsoTextUnderlineType` enumeration. FT)rur r SINGLE_LINE)r,rs r0 underlineFont.underlines8 IIKK "" " )) )r2czUSLa[RnOUSLa[RnXRlg)NTF)r rrr)rrBs r0rrs/ D=!--E e^!&&E r2)r)r)rrrr)rr)rr)rMSO_LANGUAGE_ID | None)rCrrr)rCrr Length | None)r_r)r%bool | MSO_TEXT_UNDERLINE_TYPE | None)rCr)rrrrrr(rrRrrrrrSrrrrrrrs@r0rrsA ( [[$$ 66 ]]      [[##& [[   r2rc^\rSrSrSrS U4Sjjr\S Sj5r\RS Sj5rS Sjr \SSj5r Sr S r U=r $) _HyperlinkizsText run hyperlink object. Corresponds to `a:hlinkClick` child element of the run's properties element (`a:rPr`). c8>[[U] U5 Xlgr&)r'rr(r)r,rr.r/s r0r(_Hyperlink.__init__s j$(0 r2c|URcgURRURR5$)zkThe URL of the hyperlink. Read/write. URL can be on http, https, mailto, or file scheme; others may work. N) _hlinkClickpart target_refrIdr>s r0address_Hyperlink.addresss4    #yy##D$4$4$8$899r2cpURbUR5 U(aURU5 ggr&)r _remove_hlinkClick_add_hlinkClick)r,urls r0rrs2    '  # # %    % r2cURRU[RSS9nURR U5 g)NT) is_external)r  relate_toRT HYPERLINKradd_hlinkClick)r,rrs r0r_Hyperlink._add_hlinkClicks3ii!!#r||!F   %r2c.URR$r&)r hlinkClickr>s r0r _Hyperlink._hlinkClicksyy###r2cURceURRURR5 URR 5 gr&)r r drop_relrrrr>s r0r_Hyperlink._remove_hlinkClicksB+++ 4++//0 $$&r2)r)rrr.r!r)rr)rr)rzCT_Hyperlink | None)rrrrrr(rrrrr rrrrs@r0rrs\ :: ^^&&&$$''r2rc^\rSrSrSrSU4SjjrSrSSjr\SSj5r \ RSSj5r Sr \SS j5r \SS j5r \ RSS j5r \SS j5r\RS S j5r\S!Sj5r\S"Sj5r\RS#Sj5r\S"Sj5r\RS#Sj5r\S$Sj5r\RS%Sj5r\S&Sj5r\S'Sj5rSrU=r$)(r5iz:Paragraph object. Not intended to be constructed directly.cH>[[U] U5 U=UlUlgr&)r'r5r(r)_p)r,r7r.r/s r0r(_Paragraph.__init__s  j$(0"## r2c8URR5 g)z(Add line break at end of this paragraph.N)r$add_brr>s r0add_line_break_Paragraph.add_line_breaks r2cLURR5n[X5$)z8Return a new run appended to the runs in this paragraph.)r$add_r_Run)r,rs r0add_run_Paragraph.add_runs GGMMOA}r2c.URR$)zHorizontal alignment of this paragraph. The value |None| indicates the paragraph should 'inherit' its effective value from its style hierarchy. Assigning |None| removes any explicit setting, causing its inherited value to be used. _pPralgnr>s r0 alignment_Paragraph.alignmentsyy~~r2c$XRlgr&r1rBs r0r4r5s  r2cvURRHnURRU5 M U$)z}Remove all content from this paragraph. Paragraph properties are preserved. Content includes runs, line breaks, and fields. )r)rrG)r,rs r0rI_Paragraph.clears/ ==11C MM  %2 r2c,[UR5$)a*|Font| object containing default character properties for the runs in this paragraph. These character properties override default properties inherited from parent objects such as the text frame the paragraph is contained in and they may be overridden by character properties set at the run level. )r_defRPrr>s r0font_Paragraph.fontsDLL!!r2c.URR$)zIndentation level of this paragraph. Read-write. Integer in range 0..8 inclusive. 0 represents a top-level paragraph and is the default value. Indentation level is most commonly encountered in a bulleted list, as is found on a word bullet slide. r2lvlr>s r0level_Paragraph.levelsyy}}r2c$XRlgr&r>)r,r@s r0r@rAs  r2cNURRnUcgUR$)aThe space between baselines in successive lines of this paragraph. A value of |None| indicates no explicit value is assigned and its effective value is inherited from the paragraph's style hierarchy. A numeric value, e.g. `2` or `1.5`, indicates spacing is applied in multiples of line heights. A |Length| value such as `Pt(12)` indicates spacing is a fixed height. The |Pt| value class is a convenient way to apply line spacing in units of points. N)r$pPr line_spacingr,rDs r0rE_Paragraph.line_spacings%ggkk ;r2cDURR5nXlgr&)r$get_or_add_pPrrEr,rCrDs r0rErG!gg$$& r2cV^[U4SjTRR55$)z#Sequence of runs in this paragraph.c3<># UHn[UT5v M g7fr&)r,)r{r-r,s r0r}"_Paragraph.runs..)s@,?qT!T]],?s)rur)r_lstr>s`r0runs_Paragraph.runs&s @DMM,?,?@@@r2cNURRnUcgUR$)aSThe spacing to appear between this paragraph and the subsequent paragraph. A value of |None| indicates no explicit value is assigned and its effective value is inherited from the paragraph's style hierarchy. |Length| objects provide convenience properties, such as `.pt` and `.inches`, that allow easy conversion to various length units. N)r$rD space_afterrFs r0rS_Paragraph.space_after+s#ggkk ;r2cDURR5nXlgr&)r$rIrSrJs r0rSrT9sgg$$&r2cNURRnUcgUR$)aJThe spacing to appear between this paragraph and the prior paragraph. A value of |None| indicates no explicit value is assigned and its effective value is inherited from the paragraph's style hierarchy. |Length| objects provide convenience properties, such as `.pt` and `.cm`, that allow easy conversion to various length units. N)r$rD space_beforerFs r0rW_Paragraph.space_before>s%ggkk ;r2cDURR5nXlgr&)r$rIrWrJs r0rWrXKrKr2cZSRSURR55$)aText of paragraph as a single string. Read/write. This value is formed by concatenating the text in each run and field making up the paragraph, adding a vertical-tab character (`"\v"`) for each line-break element (``, soft carriage-return) encountered. While the encoding of line-breaks as a vertical tab might be surprising at first, doing so is consistent with PowerPoint's clipboard copy behavior and allows a line-break to be distinguished from a paragraph boundary within the str return value. Assignment causes all content in the paragraph to be replaced. Each vertical-tab character (`"\v"`) in the assigned str is translated to a line-break, as is each line-feed character (`"\n"`). Contrast behavior of line-feed character in `TextFrame.text` setter. If line-feed characters are intended to produce new paragraphs, use `TextFrame.text` instead. Any other control characters in the assigned string are escaped as a hex representation like "_x001B_" (for ESC (ASCII 27) in this example). rLc38# UHoRv M g7fr&rz)r{rs r0r}"_Paragraph.text..csJ+ICxx+Ir)rr)rr>s r0rM_Paragraph.textPs#&wwJ4==+I+IJJJr2cZUR5 URRU5 gr&)rIr)rr,rMs r0rMr]es  !!$'r2c6URR5$)zThe element that defines the default run properties for runs in this paragraph. Causes the element to be added if not present. )r2get_or_add_defRPrr>s r0r:_Paragraph._defRPrjs yy**,,r2c6URR5$)z\Contains the properties for this paragraph. Causes the element to be added if not present. )r$rIr>s r0r2_Paragraph._pPrrs ww%%''r2)r)r$)r7rr.r!)rr,)rPP_PARAGRAPH_ALIGNMENT | None)rCre)rr)rr)r@r)rint | float | Length | None)rCrf)rztuple[_Run, ...]r)rCrrr)rr)rr)rrrrrr(r(r.rr4rrIr;r@rErPrSrWrMr:r2rrrs@r0r5r5s~D$ "" \\    !!AA        !!KK( [[((--((r2r5c^\rSrSrSrS U4Sjjr\S5r\S Sj5r \S5r \ RS Sj5r Sr U=r $) r,i{zCText run object. Corresponds to `a:r` child element in a paragraph.c8>[[U] U5 Xlgr&)r'r,r(_r)r,r-r.r/s r0r( _Run.__init__~s dD"6*r2cLURR5n[U5$)a@|Font| instance containing run-level character properties for the text in this run. Character properties can be and perhaps most often are inherited from parent objects such as the paragraph and slide layout the run is contained in. Only those specifically overridden at the run level are contained in the font object. )rirrr,rs r0r; _Run.fonts gg$$&Cyr2cLURR5n[X5$)aProxy for any `a:hlinkClick` element under the run properties element. Created on demand, the hyperlink object is available whether an `a:hlinkClick` element is present or not, and creates or deletes that element as appropriate in response to actions on its methods and attributes. )rirrrls r0 hyperlink_Run.hyperlinks!gg$$&#$$r2c.URR$)a"Read/write. A unicode string containing the text in this run. Assignment replaces all text in the run. The assigned value can be a 7-bit ASCII string, a UTF-8 encoded 8-bit string, or unicode. String values are converted to unicode assuming UTF-8 encoding. Any other control characters in the assigned string other than tab or newline are escaped as a hex representation. For example, ESC (ASCII 27) is escaped as "_x001B_". Contrast the behavior of `TextFrame.text` and `_Paragraph.text` with respect to line-feed and vertical-tab characters. rirMr>s r0rM _Run.textsww||r2c$XRlgr&rrr_s r0rMrss  r2)ri)r-rr.r!)rrr)rrrrrr(rr;rrorMrrrrs@r0r,r,{s_M%%   [[r2r,N)7r __future__rtypingrrr pptx.dml.fillr pptx.enum.dmlrpptx.enum.langr pptx.enum.textr r r pptx.opc.constantsr rpptx.oxml.simpletypesr pptx.shapesrpptx.text.fontsrpptx.text.layoutr pptx.utilrrrrrpptx.dml.colorrrrpptx.oxml.actionrpptx.oxml.textrrrrr pptx.typesr r!r#objectrrr5r,r2r0rs;"00$"*LL65 %'@@* .9q:q:hN 6N b''''Te(e(P.8.r2