,hCdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZddlmZGd d eZGd d e ZGd deZGddeZGdde ZGddeZGddeZy)zAxis-related chart objects.) ChartFormat)XL_AXIS_CROSSESXL_CATEGORY_TYPEXL_TICK_LABEL_POSITION XL_TICK_MARK)qn)ST_Orientation) ElementProxy)Font TextFrame) lazypropertycjeZdZdZfdZedZedZedZ e jdZ edZ e jdZ ed Z e jd Z ed Z ed Zejd ZedZejdZedZejdZedZejdZedZejdZedZedZejdZedZejdZxZS) _BaseAxiszKBase class for chart axis objects. All axis objects share these properties.cFtt| ||_||_yN)superr__init___element_xAxselfxAx __class__s Q/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/chart/axis.pyrz_BaseAxis.__init__s i')  cHt|jjS)aAAn |AxisTitle| object providing access to title properties. Calling this property is destructive in the sense that it adds an axis title element (`c:title`) to the axis XML if one is not already present. Use :attr:`has_title` to test for presence of axis title non-destructively. ) AxisTitlerget_or_add_titlers r axis_titlez_BaseAxis.axis_titles779::rc,t|jS)z The |ChartFormat| object providing access to the shape formatting properties of this axis, such as its line color and fill. rrrs rformatz_BaseAxis.format&s 4==))rc2|jjyy)a Read/write boolean value specifying whether this axis has gridlines at its major tick mark locations. Assigning |True| to this property causes major gridlines to be displayed. Assigning |False| causes them to be removed. FT)rmajorGridlinesrs rhas_major_gridlinesz_BaseAxis.has_major_gridlines. == ' ' /rct|dur|jjy|jjyNT)boolrget_or_add_majorGridlines_remove_majorGridlinesrvalues rr&z_BaseAxis.has_major_gridlines:. ;$  MM 3 3 5 MM 0 0 2rc2|jjyy)a Read/write boolean value specifying whether this axis has gridlines at its minor tick mark locations. Assigning |True| to this property causes minor gridlines to be displayed. Assigning |False| causes them to be removed. FT)rminorGridlinesrs rhas_minor_gridlinesz_BaseAxis.has_minor_gridlinesAr'rct|dur|jjy|jjyr))r*rget_or_add_minorGridlines_remove_minorGridlinesr-s rr2z_BaseAxis.has_minor_gridlinesMr/rc2|jjyy)aRead/write boolean specifying whether this axis has a title. |True| if this axis has a title, |False| otherwise. Assigning |True| causes an axis title to be added if not already present. Assigning |False| causes any existing title to be deleted. FT)rtitlers r has_titlez_BaseAxis.has_titleTs ==   &rct|dur|jjy|jjyr))r*rr _remove_titler-s rr8z_BaseAxis.has_title`s. ;$  MM * * , MM ' ' )rc,t|jS)ze The |MajorGridlines| object representing the major gridlines for this axis. )MajorGridlinesrrs rmajor_gridlinesz_BaseAxis.major_gridlinesgs dmm,,rcj|jj}|tjS|jS)z| Read/write :ref:`XlTickMark` value specifying the type of major tick mark to display on this axis. )r majorTickMarkrCROSSval)rr?s rmajor_tick_markz_BaseAxis.major_tick_marko1  33  %% %   rc|jj|tjury|jj |yNrA)r_remove_majorTickMarkrr@_add_majorTickMarkr-s rrBz_BaseAxis.major_tick_markz8 ++- L&& &  ((U(3rcB|jjjS)am Read/write float value specifying the upper limit of the value range for this axis, the number at the top or right of the vertical or horizontal value scale, respectively. The value |None| indicates the upper limit should be determined automatically based on the range of data point values associated with the axis. rscalingmaximumrs r maximum_scalez_BaseAxis.maximum_scale}}$$,,,rc>|jj}||_yrrKrr.rLs rrNz_BaseAxis.maximum_scale--''rcB|jjjS)a] Read/write float value specifying lower limit of value range, the number at the bottom or left of the value scale. |None| if no minimum scale has been set. The value |None| indicates the lower limit should be determined automatically based on the range of data point values associated with the axis. rrLminimumrs r minimum_scalez_BaseAxis.minimum_scalerOrc>|jj}||_yrrTrQs rrVz_BaseAxis.minimum_scalerRrcj|jj}|tjS|jS)zr Read/write :ref:`XlTickMark` value specifying the type of minor tick mark for this axis. )r minorTickMarkrr@rA)rrYs rminor_tick_markz_BaseAxis.minor_tick_markrCrc|jj|tjury|jj |yrE)r_remove_minorTickMarkrr@_add_minorTickMarkr-s rrZz_BaseAxis.minor_tick_markrIrcP|jjtjk(S)a2Read/write bool value specifying whether to reverse plotting order for axis. For a category axis, this reverses the order in which the categories are displayed. This may be desired, for example, on a (horizontal) bar-chart where by default the first category appears at the bottom. Since we read from top-to-bottom, many viewers may find it most natural for the first category to appear on top. For a value axis, it reverses the direction of increasing value from bottom-to-top to top-to-bottom. )r orientationr MAX_MINrs r reverse_orderz_BaseAxis.reverse_orders}}((N,B,BBBrct|dur tj|j_ytj|j_yr))r*r r`MIN_MAXrr_r-s rraz_BaseAxis.reverse_orders9'+5kT&9N " " !?M?U?U !rc,t|jS)z The |TickLabels| instance providing access to axis tick label formatting properties. Tick labels are the numbers appearing on a value axis or the category names appearing on a category axis. ) TickLabelsrrs r tick_labelsz_BaseAxis.tick_labelss$--((rc|jj}|tjS|jtjS|jS)z Read/write :ref:`XlTickLabelPosition` value specifying where the tick labels for this axis should appear. )r tickLblPosr NEXT_TO_AXISrA)rrhs rtick_label_positionz_BaseAxis.tick_label_positionsE ]]--  )66 6 >> !)66 6~~rcF|jj}||_yr)rget_or_add_tickLblPosrA)rr.rhs rrjz_BaseAxis.tick_label_positions]]88:  rcT|jj}|y|jrdSdS)zK Read/write. |True| if axis is visible, |False| otherwise. FT)rdelete_rA)rdeletes rvisiblez_BaseAxis.visibles, && > u,,rcl|dvrtd|z|jj}| |_y)N)TFz-assigned value must be True or False, got: %s) ValueErrorrget_or_add_delete_rA)rr.ros rrpz_BaseAxis.visibles6  %LuTU U113Y r)__name__ __module__ __qualname____doc__rpropertyr r r#r&setterr2r8r=rBrNrVrZrarfrjrp __classcell__rs@rrrs'U ;;**  3 3   3 3   ** --!!44 --  --  !!44  C C  ))   -- ^^rrcveZdZdZfdZedZedZejdZedZ xZ S)rz0Provides properties for manipulating axis title.c:tt| |||_yr)rrr_title)rr7rs rrzAxisTitle.__init__s i'. rc,t|jS)z|ChartFormat| object providing access to shape formatting. Return the |ChartFormat| object providing shape formatting properties for this axis title, such as its line color and fill. r"rs rr#zAxisTitle.formats4==))rc2|jjyy)adRead/write Boolean specifying presence of a text frame. Return |True| if this axis title has a text frame, and |False| otherwise. Assigning |True| causes a text frame to be added if not already present. Assigning |False| causes any existing text frame to be removed along with any text contained in the text frame. FT)r~tx_richrs rhas_text_framezAxisTitle.has_text_frames ;;   &rct|dur|jjy|jjyr))r*r~get_or_add_tx_rich _remove_txr-s rrzAxisTitle.has_text_frames. ;$  KK * * , KK " " $rcN|jj}t||S)a*|TextFrame| instance for this axis title. Return a |TextFrame| instance allowing read/write access to the text of this axis title and its text formatting properties. Accessing this property is destructive as it adds a new text frame if not already present. )r~rr )rrichs r text_framezAxisTitle.text_frames#{{--/t$$r) rtrurvrwrr r#rxrryrrzr{s@rrrsa:**  %%  % %rrc eZdZdZedZy) CategoryAxiszA category axis of a chart.c"tjS)z A member of :ref:`XlCategoryType` specifying the scale type of this axis. Unconditionally ``CATEGORY_SCALE`` for a |CategoryAxis| object. )rCATEGORY_SCALErs r category_typezCategoryAxis.category_type)s  ...rNrtrurvrwrxrrrrr&s% //rrc eZdZdZedZy)DateAxiszA category axis with dates as its category labels. This axis-type has some special display behaviors such as making length of equal periods equal and normalizing month start dates despite unequal month lengths. c"tjS)z A member of :ref:`XlCategoryType` specifying the scale type of this axis. Unconditionally ``TIME_SCALE`` for a |DateAxis| object. )r TIME_SCALErs rrzDateAxis.category_type9s  ***rNrrrrrr2s ++rrc2eZdZdZfdZedZxZS)r<zNProvides access to the properties of the major gridlines appearing on an axis.c:tt| |||_yr)rr<rrrs rrzMajorGridlines.__init__Es nd,S1 rcL|jj}t|S)z The |ChartFormat| object providing access to the shape formatting properties of this data point, such as line and fill. )rr+r)rr%s rr#zMajorGridlines.formatIs! <<>>**r)rtrurvrwrr r#rzr{s@rr<r<BsX++rr<ceZdZdZfdZedZedZejdZedZ e jdZ edZ e jd Z xZ S) rezHA service class providing access to formatting of axis tick mark labels.c8tt| ||_yr)rrerr)rxAx_elmrs rrzTickLabels.__init__Vs j$(* rcH|jj}t|}|S)z The |Font| object that provides access to the text properties for these tick labels, such as bold, italic, etc. )rdefRPrr )rrfonts rrzTickLabels.fontZs! %%F| rcL|jj}|y|jS)a Read/write string (e.g. "$#,##0.00") specifying the format for the numbers on this axis. The syntax for these strings is the same as it appears in the PowerPoint or Excel UI. Returns 'General' if no number format has been set. Note that this format string has no effect on rendered tick labels when :meth:`number_format_is_linked` is |True|. Assigning a format string to this property automatically sets :meth:`number_format_is_linked` to |False|. General)rnumFmt formatCode)rrs r number_formatzTickLabels.number_formatds'%% >   rcT|jj}||_d|_y)NF)rget_or_add_numFmtrnumber_format_is_linkedrr.rs rrzTickLabels.number_formatts$002!',$rcj|jj}|y|j}|y|jS)z Read/write boolean specifying whether number formatting should be taken from the source spreadsheet rather than the value of :meth:`number_format`. FT)rr sourceLinked)rr souceLinkeds rrz"TickLabels.number_format_is_linkedzs;%% >))  """rcF|jj}||_yr)rrrrs rrz"TickLabels.number_format_is_linkeds002#rcL|jj}|y|jS)z Read/write int value in range 0-1000 specifying the spacing between the tick mark labels and the axis as a percentange of the default value. 100 if no label offset setting is present. d)r lblOffsetrA)rrs roffsetzTickLabels.offsets&MM++  }}rc|jjtdk7r td|jj |dk(ry|jj }||_y)Nzc:catAxz"only a category axis has an offsetr)rtagrrr_remove_lblOffset_add_lblOffsetrA)rr.rs rrzTickLabels.offsetsW ==  9 -AB B '') C< MM002  r) rtrurvrwrr rrxrryrrrzr{s@rrereSsR  ! !--  # ###$$$   ]]rreceZdZdZedZej dZedZej dZedZej dZedZ e j d Z ed Z y ) ValueAxiszAn axis having continuous (as opposed to discrete) values. The vertical axis is generally a value axis, however both axes of an XY-type chart are value axes. cj|jj}|tjS|jS)a Member of :ref:`XlAxisCrosses` enumeration specifying the point on this axis where the other axis crosses, such as auto/zero, minimum, or maximum. Returns `XL_AXIS_CROSSES.CUSTOM` when a specific numeric crossing point (e.g. 1.5) is defined. ) _cross_xAxcrossesrCUSTOMrA)rrs rrzValueAxis.crossess.//)) ?")) ){{rc |j}|tjk(r |jy|j |j |tjk(r|j dy|j|y)NgrF)rrr crossesAt_remove_crosses_remove_crossesAt_add_crossesAt _add_crossesrr. cross_xAxs rrzValueAxis.crossesspOO O** *"".!!###% O** *  $ $ $ -  " "u " -rcL|jj}|y|jS)z Numeric value on this axis at which the perpendicular axis crosses. Returns |None| if no crossing value is set. N)rrrA)rrs r crosses_atzValueAxis.crosses_ats& OO--  }}rc|j}|j|j|y|j|yrE)rrrrrs rrzValueAxis.crosses_ats<OO !!###% =   U +rcL|jj}|y|jS)a The float number of units between major tick marks on this value axis. |None| corresponds to the 'Auto' setting in the UI, and specifies the value should be calculated by PowerPoint based on the underlying chart data. N)r majorUnitrA)rrs r major_unitzValueAxis.major_unit&MM++  }}rcv|jj|y|jj|yrE)r_remove_majorUnit_add_majorUnitr-s rrzValueAxis.major_unit/ '') =  $$$/rcL|jj}|y|jS)a The float number of units between minor tick marks on this value axis. |None| corresponds to the 'Auto' setting in the UI, and specifies the value should be calculated by PowerPoint based on the underlying chart data. N)r minorUnitrA)rrs r minor_unitzValueAxis.minor_unitrrcv|jj|y|jj|yrE)r_remove_minorUnit_add_minorUnitr-s rrzValueAxis.minor_unitrrc|jjj}d|z}|jj|d}|j S)zh The axis element in the same group (primary/secondary) that crosses this axis. z9(../c:catAx | ../c:valAx | ../c:dateAx)/c:axId[@val="%d"]r)rcrossAxrAxpath getparent)r crossAx_idexpr cross_axIds rrzValueAxis._cross_xAxsK ]]**.. JZW]]((.q1 ##%%rN) rtrurvrwrxrryrrrrrrrrrs    ^^ . .,,  00   00 &&rrN)rwpptx.dml.chtfmtrpptx.enum.chartrrrr pptx.oxml.nsrpptx.oxml.simpletypesr pptx.sharedr pptx.text.textr r pptx.utilr objectrrrrr<rerrrrrs"' 0$*"__D.% .%b /9 / +y + +\+"OOdf& f&r