,h8%hdZddlmZmZmZmZddlmZmZddl m Z Gdde Z Gdd e Z y ) z Data label-related objects. )absolute_importdivisionprint_functionunicode_literals)Font TextFrame) lazypropertyceZdZdZfdZedZedZejdZedZ e jdZ edZ e jd Z ed Z e jd Z ed Z e jd Z edZejdZedZejdZedZejdZxZS) DataLabelsa?Provides access to properties of data labels for a plot or a series. This is not a collection and does not provide access to individual data labels. Access to individual labels is via the |Point| object. The properties this object provides control formatting of *all* the data labels in its scope. c8tt| ||_yN)superr __init___element)selfdLbls __class__s V/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/chart/datalabel.pyrzDataLabels.__init__s j$(* cH|jj}t|}|S)z The |Font| object that provides access to the text properties for these data labels, such as bold, italic, etc. )rdefRPrr)rrfonts rrzDataLabels.fonts! %%F| rcL|jj}|y|jS)a Read/write string specifying the format for the numbers on this set of data labels. Returns 'General' if no number format has been set. Note that this format string has no effect on rendered data 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_formatzDataLabels.number_format$s'%% >   rcP||jj_d|_y)NF)rget_or_add_numFmtrnumber_format_is_linkedrvalues rrzDataLabels.number_format3s7< '')4',$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`. T)rr sourceLinked)rr souceLinkeds rr!z"DataLabels.number_format_is_linked8s;%% >))  """rcF|jj}||_yr)rr r%)rr#rs rr!z"DataLabels.number_format_is_linkedGs002#rcL|jj}|y|jS)a< Read/write :ref:`XlDataLabelPosition` enumeration value specifying the position of the data labels with respect to their data point, or |None| if no position is specified. Assigning |None| causes PowerPoint to choose the default position, which varies by chart type. N)rdLblPosval)rr)s rpositionzDataLabels.positionLs%--'' ?{{rc|||jjy||jj_yr)r_remove_dLblPosget_or_add_dLblPosr*r"s rr+zDataLabels.positionZs/ = MM ) ) + 16 ((*.rcJ|jjjS)z>Read/write. True when name of category should appear in label.)rget_or_add_showCatNamer*rs rshow_category_namezDataLabels.show_category_namea}}335999rcTt||jj_yr)boolrr0r*r"s rr2zDataLabels.show_category_namef59%[ ,,.2rcJ|jjjS)z>Read/write. True when data label displays legend-color swatch.)rget_or_add_showLegendKeyr*r1s rshow_legend_keyzDataLabels.show_legend_keyjs}}557;;;rcTt||jj_yr)r5rr8r*r"s rr9zDataLabels.show_legend_keyos7;E{ ..04rcJ|jjjS)zRead/write. True when data label displays percentage. This option is not operative on all chart types. Percentage appears on polar charts such as pie and donut. )rget_or_add_showPercentr*r1s rshow_percentagezDataLabels.show_percentagess}}335999rcTt||jj_yr)r5rr<r*r"s rr=zDataLabels.show_percentage|r6rcJ|jjjS)z6Read/write. True when data label displays series name.)rget_or_add_showSerNamer*r1s rshow_series_namezDataLabels.show_series_namer3rcTt||jj_yr)r5rr@r*r"s rrAzDataLabels.show_series_namer6rcJ|jjjS)z@Read/write. True when label displays numeric value of datapoint.)rget_or_add_showValr*r1s r show_valuezDataLabels.show_values}}//1555rcTt||jj_yr)r5rrDr*r"s rrEzDataLabels.show_values15e ((*.r)__name__ __module__ __qualname____doc__rr rpropertyrsetterr!r+r2r9r=rArE __classcell__rs@rr r s ! !-- # ###$$$  __77 ::AA<<CC::AA::AA66==rr ceZdZdZfdZedZedZejdZedZ e jdZ edZ ed Z d Z d Zd Zd ZdZxZS) DataLabelzB The data label associated with an individual data point. cTtt| |x|_|_||_yr)rrPr_serr_idx)rseridxrs rrzDataLabel.__init__s% i')$'' DM rcp|j}t||}|jd}|jS)aThe |Font| object providing text formatting for this data label. This font object is used to customize the appearance of automatically inserted text, such as the data point value. The font applies to the entire data label. More granular control of the appearance of custom data label text is controlled by a font object on runs in the text frame. r)_get_or_add_txPrr paragraphsr)rtxPr text_frame paragraphs rrzDataLabel.fonts8$$&tT* ))!, ~~rcF|j}|y|jdryy)a] Return |True| if this data label has a text frame (implying it has custom data label text), 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. Fz c:tx/c:richT)_dLblxpathrdLbls rhas_text_framezDataLabel.has_text_frames'zz < ::m $rc`t|dur|jy|jy)NT)r5_get_or_add_tx_rich_remove_tx_richr"s rrazDataLabel.has_text_frames& ;$   $ $ &  "rcV|j}|y|j}|y|jS)a' Read/write :ref:`XlDataLabelPosition` member specifying the position of this data label with respect to its data point, or |None| if no position is specified. Assigning |None| causes PowerPoint to choose the default position, which varies by chart type. N)r]r)r*)rr`r)s rr+zDataLabel.positions0zz <,, ?{{rc| |j}|y|jy|j}||j_yr)r]r-_get_or_add_dLblr.r*)rr#r`s rr+zDataLabel.positionsF =::D|  " $$&(-!%rc:|j}t||S)z |TextFrame| instance for this data label, containing the text of the data label and providing access to its text formatting properties. )_get_or_add_richr )rrichs rrZzDataLabel.text_frames $$&t$$rcL|jj|jS)z Return the |CT_DLbl| instance referring specifically to this individual data label (having the same index value), or |None| if not present. )rRget_dLblrSr1s rr]zDataLabel._dLblsyy!!$)),,rcL|jj|jS)z The ``CT_DLbl`` instance referring specifically to this individual data label, newly created if not yet present in the XML. )rRget_or_add_dLblrSr1s rrgzDataLabel._get_or_add_dLbls yy((33rc|j}|j|j|jS)z Return the `c:rich` element representing the text frame for this data label, newly created with its ancestors if not present. )rg _remove_spPr _remove_txPrget_or_add_richr_s rrizDataLabel._get_or_add_richs; $$&  ##%%rc|j}|j|j|jS)z Return the `c:tx` element for this data label, with its `c:rich` child and descendants, newly created if not yet present. )rgrprqget_or_add_tx_richr_s rrczDataLabel._get_or_add_tx_richs; $$&  &&((rcB|j}|jS)zReturn the `c:txPr` element for this data label. The `c:txPr` element and its parent `c:dLbl` element are created if not yet present. )rgget_or_add_txPrr_s rrWzDataLabel._get_or_add_txPrs! $$&##%%rcB|j}|y|jy)z Remove any `c:tx/c:rich` child of the `c:dLbl` element for this data label. Do nothing if that element is not present. N)r]remove_tx_richr_s rrdzDataLabel._remove_tx_richs! zz <  r)rGrHrIrJrr rrKrarLr+rZr]rgrircrWrdrMrNs@rrPrPs     ##   __..%%--4 & )&rrPN)rJ __future__rrrr text.textrr utilr objectr rPrrr~s6SR'C=C=LQQr