elmau
/
easymacro
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
easymacro/doc/public/es/calc/cells/properties/index.html

1941 lines
56 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<html lang="es" class="js csstransforms3d">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Hugo 0.101.0" />
<meta name="description" content="">
<link rel="icon" href="/easymacro/images/favicon.png" type="image/png">
<title>Propiedades :: Documentación para EasyMacro</title>
<link href="/easymacro/css/nucleus.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/fontawesome-all.min.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/hybrid.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/featherlight.min.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/perfect-scrollbar.min.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/auto-complete.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/atom-one-dark-reasonable.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/theme.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/tabs.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/hugo-theme.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/theme-blue.css?1661091037" rel="stylesheet">
<link href="/easymacro/css/custom.css?1661091037" rel="stylesheet">
<script src="/easymacro/js/jquery-3.3.1.min.js?1661091037"></script>
<style>
:root #header + #content > #left > #rlblock_left{
display:none !important;
}
</style>
</head>
<body class="" data-url="/easymacro/es/calc/cells/properties/">
<nav id="sidebar" class="">
<div id="header-wrapper">
<div id="header">
<a id="logo" href='/easymacro/es'>
<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
width="100.000000pt" height="75.000000pt" viewBox="0 0 200.000000 150.000000"
preserveAspectRatio="xMidYMid meet">
<g transform="translate(0.000000,149.000000) scale(0.100000,-0.100000)"
fill="#000000" stroke="none">
<path d="M1181 1473 c-19 -10 -43 -30 -54 -45 -24 -32 -33 -110 -19 -160 5
-19 7 -40 3 -45 -5 -9 -83 -26 -106 -23 -5 1 -32 3 -60 6 -51 4 -133 28 -240
69 -34 13 -83 26 -110 30 -72 10 -118 21 -228 58 -83 27 -99 30 -107 18 -12
-21 4 -47 50 -77 21 -14 41 -32 44 -40 7 -18 66 -54 88 -54 10 0 44 -20 75
-44 51 -39 131 -76 165 -76 5 0 32 -16 58 -35 26 -19 53 -35 59 -35 12 0 14
-46 4 -133 -7 -61 -47 -112 -97 -120 -19 -3 -53 -18 -76 -33 -46 -31 -240
-268 -310 -381 -30 -48 -53 -74 -70 -78 -29 -8 -190 -169 -190 -190 0 -27 15
-16 87 63 41 45 87 85 110 96 30 13 50 34 84 89 24 39 95 136 157 214 113 143
171 193 220 193 27 0 86 52 100 87 6 16 12 68 15 116 l3 88 -30 16 c-17 9 -47
29 -67 44 -20 16 -47 29 -60 29 -36 1 -106 36 -159 80 -29 25 -58 40 -74 40
-18 0 -40 13 -64 38 -21 20 -51 47 -68 59 -27 21 -24 21 52 -6 45 -16 126 -37
180 -46 55 -10 116 -26 136 -35 21 -10 61 -23 90 -30 29 -7 62 -17 73 -23 18
-9 130 -28 165 -27 8 0 36 3 63 6 38 5 50 11 61 33 8 16 10 36 5 51 -43 145
73 260 167 166 34 -34 34 -34 34 -130 0 -85 -2 -96 -20 -106 -17 -9 -70 -87
-70 -103 0 -4 24 -7 54 -7 38 0 60 -6 79 -20 14 -11 39 -20 56 -20 33 0 151
-41 188 -66 12 -8 46 -23 75 -34 48 -18 184 -100 166 -100 -4 0 -22 6 -40 14
-78 33 -157 49 -217 43 -35 -4 -81 -1 -112 6 -30 7 -81 12 -114 12 l-60 -1
-45 -84 c-49 -93 -42 -85 -404 -435 -198 -192 -250 -234 -347 -288 -23 -13
-29 -21 -21 -29 7 -7 32 2 84 32 58 32 122 89 286 248 117 114 247 239 290
279 63 58 88 89 127 163 l49 92 70 -7 c39 -3 121 -10 181 -14 119 -9 166 -19
232 -46 94 -38 101 15 11 73 -90 58 -314 158 -372 167 -27 4 -60 14 -74 23
-14 9 -43 18 -65 22 l-41 5 38 38 c37 38 38 38 42 135 5 85 3 101 -15 129 -40
64 -111 87 -170 56z"/>
<path d="M1120 210 c0 -109 2 -130 15 -130 13 0 15 21 15 130 0 109 -2 130
-15 130 -13 0 -15 -21 -15 -130z"/>
<path d="M900 200 l0 -120 80 0 c64 0 80 3 80 15 0 12 -14 15 -65 15 l-65 0 0
45 0 45 60 0 c47 0 60 3 60 15 0 12 -13 15 -60 15 l-60 0 0 35 0 35 65 0 c37
0 65 4 65 10 0 6 -33 10 -80 10 l-80 0 0 -120z"/>
<path d="M1320 200 c0 -100 3 -120 15 -120 12 0 15 18 15 102 0 56 3 98 7 94
4 -3 18 -37 33 -74 34 -90 53 -90 89 0 14 36 30 70 34 74 4 4 7 -38 7 -94 0
-84 3 -102 15 -102 13 0 15 20 15 120 l0 120 -27 0 c-26 0 -31 -7 -59 -83
l-31 -82 -29 83 c-27 76 -31 82 -56 82 l-28 0 0 -120z"/>
<path d="M1628 263 c-10 -2 -18 -10 -18 -16 0 -8 16 -11 49 -9 41 3 51 0 60
-16 9 -18 6 -20 -35 -25 -48 -5 -84 -30 -84 -58 0 -54 43 -79 93 -54 20 10 33
12 35 5 2 -5 11 -10 19 -10 13 0 15 13 11 76 -3 65 -7 79 -27 95 -22 18 -63
23 -103 12z m97 -115 c-14 -48 -66 -62 -89 -25 -15 24 15 47 62 47 30 0 33 -2
27 -22z"/>
<path d="M1820 187 c0 -58 4 -77 18 -89 27 -24 48 -27 76 -13 14 8 26 10 26 4
0 -5 7 -9 15 -9 12 0 15 17 15 90 0 73 -3 90 -15 90 -12 0 -15 -14 -15 -64 0
-68 -14 -96 -49 -96 -31 0 -41 22 -41 92 0 54 -3 68 -15 68 -12 0 -15 -15 -15
-73z"/>
</g>
</svg>
</a>
</div>
<div class="searchbox">
<label for="search-by"><i class="fas fa-search"></i></label>
<input data-search-input id="search-by" type="search" placeholder="Buscar...">
<span data-search-clear=""><i class="fas fa-times"></i></span>
</div>
<script type="text/javascript" src="/easymacro/js/lunr.min.js?1661091037"></script>
<script type="text/javascript" src="/easymacro/js/auto-complete.js?1661091037"></script>
<script type="text/javascript">
var baseurl = "https:\/\/doc.cuates.net\/easymacro\/es";
</script>
<script type="text/javascript" src="/easymacro/js/search.js?1661091037"></script>
</div>
<section id="homelinks">
<ul>
<li>
<a class="padding" href='/easymacro/es'><i class='fas fa-home'></i> Inicio</a>
</li>
</ul>
</section>
<div class="highlightable">
<ul class="topics">
<li data-nav-id="/easymacro/es/installation/" title="Instalación" class="dd-item
">
<a href="/easymacro/es/installation/">
Instalación
</a>
</li>
<li data-nav-id="/easymacro/es/tools_debug/" title="Herramientas para depurar" class="dd-item
">
<a href="/easymacro/es/tools_debug/">
Herramientas para depurar
</a>
</li>
<li data-nav-id="/easymacro/es/tools/" title="Herramientas" class="dd-item
">
<a href="/easymacro/es/tools/">
Herramientas
</a>
<ul>
<li data-nav-id="/easymacro/es/tools/messages/" title="Mensajes" class="dd-item
">
<a href="/easymacro/es/tools/messages/">
Mensajes
</a>
</li>
<li data-nav-id="/easymacro/es/tools/dates_and_time/" title="Fechas y tiempo" class="dd-item
">
<a href="/easymacro/es/tools/dates_and_time/">
Fechas y tiempo
</a>
</li>
<li data-nav-id="/easymacro/es/tools/paths/" title="Rutas y archivos" class="dd-item
">
<a href="/easymacro/es/tools/paths/">
Rutas y archivos
</a>
</li>
<li data-nav-id="/easymacro/es/tools/email/" title="Correo electrónico" class="dd-item
">
<a href="/easymacro/es/tools/email/">
Correo electrónico
</a>
</li>
<li data-nav-id="/easymacro/es/tools/threads/" title="Hilos" class="dd-item
">
<a href="/easymacro/es/tools/threads/">
Hilos
</a>
</li>
<li data-nav-id="/easymacro/es/tools/macros/" title="Ejecutar macros" class="dd-item
">
<a href="/easymacro/es/tools/macros/">
Ejecutar macros
</a>
</li>
<li data-nav-id="/easymacro/es/tools/timer/" title="Timer" class="dd-item
">
<a href="/easymacro/es/tools/timer/">
Timer
</a>
</li>
<li data-nav-id="/easymacro/es/tools/url/" title="URL" class="dd-item
">
<a href="/easymacro/es/tools/url/">
URL
</a>
</li>
<li data-nav-id="/easymacro/es/tools/utils/" title="Utilidades" class="dd-item
">
<a href="/easymacro/es/tools/utils/">
Utilidades
</a>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/application/" title="LibreOffice" class="dd-item
">
<a href="/easymacro/es/application/">
LibreOffice
</a>
<ul>
<li data-nav-id="/easymacro/es/application/shortcuts/" title="Accesos directos" class="dd-item
">
<a href="/easymacro/es/application/shortcuts/">
Accesos directos
</a>
</li>
<li data-nav-id="/easymacro/es/application/menus/" title="Menús" class="dd-item
">
<a href="/easymacro/es/application/menus/">
Menús
</a>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/documents/" title="Documentos" class="dd-item
">
<a href="/easymacro/es/documents/">
Documentos
</a>
<ul>
<li data-nav-id="/easymacro/es/documents/properties/" title="Propiedades" class="dd-item
">
<a href="/easymacro/es/documents/properties/">
Propiedades
</a>
</li>
<li data-nav-id="/easymacro/es/documents/methods/" title="Métodos" class="dd-item
">
<a href="/easymacro/es/documents/methods/">
Métodos
</a>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/calc/" title="Calc" class="dd-item
parent
">
<a href="/easymacro/es/calc/">
Calc
</a>
<ul>
<li data-nav-id="/easymacro/es/calc/sheets/" title="Hojas" class="dd-item
">
<a href="/easymacro/es/calc/sheets/">
Hojas
</a>
<ul>
<li data-nav-id="/easymacro/es/calc/sheets/properties/" title="Propiedades" class="dd-item
">
<a href="/easymacro/es/calc/sheets/properties/">
Propiedades
</a>
</li>
<li data-nav-id="/easymacro/es/calc/sheets/methods/" title="Métodos" class="dd-item
">
<a href="/easymacro/es/calc/sheets/methods/">
Métodos
</a>
</li>
<li data-nav-id="/easymacro/es/calc/sheets/events/" title="Eventos" class="dd-item
">
<a href="/easymacro/es/calc/sheets/events/">
Eventos
</a>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/calc/ranges/" title="Conjuntos de Rangos" class="dd-item
">
<a href="/easymacro/es/calc/ranges/">
Conjuntos de Rangos
</a>
<ul>
<li data-nav-id="/easymacro/es/calc/ranges/properties/" title="Propiedades" class="dd-item
">
<a href="/easymacro/es/calc/ranges/properties/">
Propiedades
</a>
</li>
<li data-nav-id="/easymacro/es/calc/ranges/methods/" title="Métodos" class="dd-item
">
<a href="/easymacro/es/calc/ranges/methods/">
Métodos
</a>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/calc/cells/" title="Celdas y rangos" class="dd-item
parent
">
<a href="/easymacro/es/calc/cells/">
Celdas y rangos
</a>
<ul>
<li data-nav-id="/easymacro/es/calc/cells/properties/" title="Propiedades" class="dd-item
active
">
<a href="/easymacro/es/calc/cells/properties/">
Propiedades
</a>
</li>
<li data-nav-id="/easymacro/es/calc/cells/methods/" title="Métodos" class="dd-item
">
<a href="/easymacro/es/calc/cells/methods/">
Métodos
</a>
</li>
</ul>
</li>
</ul>
</li>
<li data-nav-id="/easymacro/es/dialog/" title="Cuadros de diálogo" class="dd-item
">
<a href="/easymacro/es/dialog/">
Cuadros de diálogo
</a>
</li>
</ul>
<section id="shortcuts">
<h3>Más</h3>
<ul>
<li>
<a class="padding" href="https://git.cuates.net/elmau/easymacro"><i class='fab fa-gitlab'></i> Git Repo</a>
</li>
</ul>
</section>
<section id="prefooter">
<hr/>
<ul>
<li>
<a class="padding">
<i class="fas fa-language fa-fw"></i>
<div class="select-style">
<select id="select-language" onchange="location = this.value;">
<option id="es" value="https://doc.cuates.net/easymacro/es/calc/cells/properties/" selected>Español</option>
</select>
<svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
<g>
<g id="arrow-drop-down">
<polygon points="0,63.75 127.5,191.25 255,63.75 " />
</g>
</g>
</svg>
</div>
</a>
</li>
</ul>
</section>
<section id="footer">
<p>Built with <a href="https://github.com/matcornic/hugo-theme-learn"><i class="fas fa-heart"></i></a> from <a href="https://getgrav.org">Grav</a> and <a href="https://gohugo.io/">Hugo</a></p>
</section>
</div>
</nav>
<section id="body">
<div id="overlay"></div>
<div class="padding highlightable">
<div>
<div id="top-bar">
<div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
<span id="sidebar-toggle-span">
<a href="#" id="sidebar-toggle" data-sidebar-toggle="">
<i class="fas fa-bars"></i>
</a>
</span>
<span id="toc-menu"><i class="fas fa-list-alt"></i></span>
<span class="links">
<a href='/easymacro/es/'></a> > <a href='/easymacro/es/calc/'>Calc</a> > <a href='/easymacro/es/calc/cells/'>Celdas y rangos</a> > Propiedades
</span>
</div>
<div class="progress">
<div class="wrapper">
<nav id="TableOfContents">
<ul>
<li>
<ul>
<li><a href="#is_cell">is_cell</a></li>
<li><a href="#name">name</a></li>
<li><a href="#address">address</a></li>
<li><a href="#range_address">range_address</a></li>
<li><a href="#filas-y-columnas">filas y columnas</a></li>
<li><a href="#sheet">sheet</a></li>
<li><a href="#doc">doc</a></li>
<li><a href="#style">style</a></li>
<li><a href="#current_region">current_region</a></li>
<li><a href="#range_data">range_data</a></li>
<li><a href="#back_color">back_color</a></li>
<li><a href="#type">type</a></li>
<li><a href="#error">error</a></li>
<li><a href="#string">string</a></li>
<li><a href="#float">float</a></li>
<li><a href="#formula">formula</a></li>
<li><a href="#date">date</a></li>
<li><a href="#time">time</a></li>
<li><a href="#datetime">datetime</a></li>
<li><a href="#value">value</a></li>
<li><a href="#data_array">data_array</a></li>
<li><a href="#formula_array">formula_array</a></li>
<li><a href="#data">data</a></li>
<li><a href="#dict">dict</a></li>
<li><a href="#next_free">next_free</a></li>
</ul>
</li>
</ul>
</nav>
</div>
</div>
</div>
</div>
<div id="head-tags">
</div>
<div id="body-inner">
<h1>
Propiedades
</h1>
<h3 id="is_cell">is_cell</h3>
<p>Verdadero (True) si el rango es de una sola celda.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>is_cell)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(rango<span style="color:#f92672">.</span>is_cell)
</span></span></code></pre></div><h3 id="name">name</h3>
<p>Devuelve la dirección de la celda o rango como texto.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>name)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(rango<span style="color:#f92672">.</span>name)
</span></span></code></pre></div><h3 id="address">address</h3>
<p>Devuelve la dirección de la celda como una estructura: <code>com.sun.star.table.CellAddress</code></p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">if</span> celda<span style="color:#f92672">.</span>is_cell:
</span></span><span style="display:flex;"><span> app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>address)
</span></span></code></pre></div><h3 id="range_address">range_address</h3>
<p>Devuelve la dirección del rango como una estructura: <code>com.sun.star.table.CellRangeAddress</code></p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">if</span> <span style="color:#f92672">not</span> rango<span style="color:#f92672">.</span>is_cell:
</span></span><span style="display:flex;"><span> app<span style="color:#f92672">.</span>debug(rango<span style="color:#f92672">.</span>range_address)
</span></span></code></pre></div><h3 id="filas-y-columnas">filas y columnas</h3>
<p>Devolver el tamaño del rango en filas y columnas.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:E100&#39;</span>]
</span></span><span style="display:flex;"><span>filas <span style="color:#f92672">=</span> len(rango)
</span></span><span style="display:flex;"><span>columnas <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>len_columns
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(filas, columnas)
</span></span></code></pre></div><h3 id="sheet">sheet</h3>
<p>Devuelve la hoja padre.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>sheet
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(hoja)
</span></span></code></pre></div><h3 id="doc">doc</h3>
<p>Devuelve el documento padre.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>doc <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>doc
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(doc)
</span></span></code></pre></div><h3 id="style">style</h3>
<p>Devuelve o aplica el estilo de celda.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:C5&#39;</span>]
</span></span><span style="display:flex;"><span>rango<span style="color:#f92672">.</span>style <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;Good&#39;</span>
</span></span></code></pre></div><h3 id="current_region">current_region</h3>
<p>Devuelve la región actual.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> celda<span style="color:#f92672">.</span>current_region
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(rango)
</span></span></code></pre></div><h3 id="range_data">range_data</h3>
<p>Devuelve la región actual del rango excepto la primer fila.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> celda<span style="color:#f92672">.</span>range_data
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(rango)
</span></span></code></pre></div><h3 id="back_color">back_color</h3>
<p>Devuelve o aplica el color de fondo del rango.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1:E10&#39;</span>]
</span></span><span style="display:flex;"><span>rango<span style="color:#f92672">.</span>back_color <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;red&#39;</span>
</span></span></code></pre></div><h3 id="type">type</h3>
<p>Devuelve el tipo de contenido de la celda: texto, número o formula.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type)
</span></span></code></pre></div><h3 id="error">error</h3>
<p>Si la celda tiene una formula con error, devuelve el número de error.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>error)
</span></span></code></pre></div><h3 id="string">string</h3>
<p>Devuelve o establece el contenido de la celda como texto.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>string <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;Maldito Mundo&#39;</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>string)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A2&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>string <span style="color:#f92672">=</span> <span style="color:#ae81ff">12345</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>string)
</span></span></code></pre></div><h3 id="float">float</h3>
<p>Devuelve o establece el contenido de la celda como valor.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>float <span style="color:#f92672">=</span> <span style="color:#ae81ff">12345</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>float)
</span></span></code></pre></div><h3 id="formula">formula</h3>
<p>Devuelve o establece la formula de la celda.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>formula <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;=RAND()&#39;</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>formula)
</span></span></code></pre></div><h3 id="date">date</h3>
<p>Devuelve o establece el contenido de la celda como fecha.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>date <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>dates<span style="color:#f92672">.</span>date(<span style="color:#ae81ff">1974</span>, <span style="color:#ae81ff">1</span>, <span style="color:#ae81ff">15</span>)
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(type(celda<span style="color:#f92672">.</span>date), celda<span style="color:#f92672">.</span>date)
</span></span></code></pre></div><pre tabindex="0"><code>20/08/2022 18:38:53 - DEBUG - &lt;class &#39;datetime.date&#39;&gt; 1974-01-15
</code></pre><h3 id="time">time</h3>
<p>Devuelve o establece el contenido de la celda como tiempo.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>time <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>dates<span style="color:#f92672">.</span>time(<span style="color:#ae81ff">10</span>, <span style="color:#ae81ff">11</span>, <span style="color:#ae81ff">12</span>)
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(type(celda<span style="color:#f92672">.</span>time), celda<span style="color:#f92672">.</span>time)
</span></span></code></pre></div><h3 id="datetime">datetime</h3>
<p>Devuelve o establece el contenido de la celda como fecha y tiempo.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>datetime <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>dates<span style="color:#f92672">.</span>datetime(<span style="color:#ae81ff">1974</span>, <span style="color:#ae81ff">1</span>, <span style="color:#ae81ff">15</span>, <span style="color:#ae81ff">10</span>, <span style="color:#ae81ff">11</span>, <span style="color:#ae81ff">12</span>)
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(type(celda<span style="color:#f92672">.</span>datetime), celda<span style="color:#f92672">.</span>datetime)
</span></span></code></pre></div><h3 id="value">value</h3>
<p>Devuelve o establece el valor de la celda, estableciendo el tipo de dato automáticamente.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>value <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;Soy Texto&#39;</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>value)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A2&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>value <span style="color:#f92672">=</span> <span style="color:#ae81ff">12345</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>value)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A3&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>value <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;=RAND()&#39;</span>
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>value)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A4&#39;</span>]
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>value <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>dates<span style="color:#f92672">.</span>date(<span style="color:#ae81ff">1974</span>, <span style="color:#ae81ff">1</span>, <span style="color:#ae81ff">15</span>)
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>type, celda<span style="color:#f92672">.</span>value)
</span></span></code></pre></div><h3 id="data_array">data_array</h3>
<p>Devuelve o establece los datos de un rango. Es un alias de DataArray.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>selection
</span></span><span style="display:flex;"><span>datos <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>data_array
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(datos)
</span></span><span style="display:flex;"><span>rango<span style="color:#f92672">.</span>data_array <span style="color:#f92672">=</span> datos
</span></span></code></pre></div>
<div class="notices warning" ><p>El tamaño de los datos, debe ser <strong>exactamente</strong> del tamaño del rango destino. De lo contrario obtendrá un error.</p>
</div>
<h3 id="formula_array">formula_array</h3>
<p>Devuelve o establece los datos de un rango. Es un alias de FormulaArray.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>rango <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>selection
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>datos <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>data_array
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(datos)
</span></span><span style="display:flex;"><span>datos <span style="color:#f92672">=</span> rango<span style="color:#f92672">.</span>formula_array
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(datos)
</span></span><span style="display:flex;"><span>rango<span style="color:#f92672">.</span>formula_array <span style="color:#f92672">=</span> datos
</span></span></code></pre></div>
<div class="notices tip" ><p><strong>data_array</strong> devolverá los resultados de las celdas con formulas. <strong>formula_array</strong> devolverá las formulas en dichas celdas.</p>
</div>
<h3 id="data">data</h3>
<p>Alias de <code>data_array</code> al obtener los datos. Al establecer los datos, si es un rango se comporta como <code>data_array</code>, pero si es una celda, se autoajusta al tamaño de los datos.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>datos <span style="color:#f92672">=</span> (
</span></span><span style="display:flex;"><span> (<span style="color:#ae81ff">1</span>, <span style="color:#e6db74">&#39;Uno&#39;</span>),
</span></span><span style="display:flex;"><span> (<span style="color:#ae81ff">2</span>, <span style="color:#e6db74">&#39;Dos&#39;</span>),
</span></span><span style="display:flex;"><span> (<span style="color:#ae81ff">3</span>, <span style="color:#e6db74">&#39;Tres&#39;</span>),
</span></span><span style="display:flex;"><span>)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>data <span style="color:#f92672">=</span> datos
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>current_region<span style="color:#f92672">.</span>data)
</span></span></code></pre></div>
<div class="notices tip" ><p>Siempre valide que haya suficientes celdas libres para los datos para evitar sobreescribirlos.</p>
</div>
<h3 id="dict">dict</h3>
<p>Devuelve o establece los datos como diccionarios.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>datos <span style="color:#f92672">=</span> (
</span></span><span style="display:flex;"><span> {<span style="color:#e6db74">&#39;No&#39;</span>: <span style="color:#ae81ff">1</span>, <span style="color:#e6db74">&#39;Nombre&#39;</span>: <span style="color:#e6db74">&#39;Ingrid&#39;</span>},
</span></span><span style="display:flex;"><span> {<span style="color:#e6db74">&#39;No&#39;</span>: <span style="color:#ae81ff">2</span>, <span style="color:#e6db74">&#39;Nombre&#39;</span>: <span style="color:#e6db74">&#39;Sophia&#39;</span>},
</span></span><span style="display:flex;"><span> {<span style="color:#e6db74">&#39;No&#39;</span>: <span style="color:#ae81ff">3</span>, <span style="color:#e6db74">&#39;Nombre&#39;</span>: <span style="color:#e6db74">&#39;Scarlette&#39;</span>},
</span></span><span style="display:flex;"><span>)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda<span style="color:#f92672">.</span>dict <span style="color:#f92672">=</span> datos
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda<span style="color:#f92672">.</span>current_region<span style="color:#f92672">.</span>dict)
</span></span></code></pre></div><h3 id="next_free">next_free</h3>
<p>Devuelve la siguiente celda libre después de la región actual.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>hoja <span style="color:#f92672">=</span> app<span style="color:#f92672">.</span>active_sheet
</span></span><span style="display:flex;"><span>celda <span style="color:#f92672">=</span> hoja[<span style="color:#e6db74">&#39;A1&#39;</span>]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>celda_libre <span style="color:#f92672">=</span> celda<span style="color:#f92672">.</span>next_free
</span></span><span style="display:flex;"><span>app<span style="color:#f92672">.</span>debug(celda_libre)
</span></span></code></pre></div>
<footer class=" footline" >
</footer>
</div>
</div>
<div id="navigation">
<a class="nav nav-prev" href="/easymacro/es/calc/cells/" title="Celdas y rangos"> <i class="fa fa-chevron-left"></i></a>
<a class="nav nav-next" href="/easymacro/es/calc/cells/methods/" title="Métodos" style="margin-right: 0px;"><i class="fa fa-chevron-right"></i></a>
</div>
</section>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
<script src="/easymacro/js/clipboard.min.js?1661091037"></script>
<script src="/easymacro/js/perfect-scrollbar.min.js?1661091037"></script>
<script src="/easymacro/js/perfect-scrollbar.jquery.min.js?1661091037"></script>
<script src="/easymacro/js/jquery.sticky.js?1661091037"></script>
<script src="/easymacro/js/featherlight.min.js?1661091037"></script>
<script src="/easymacro/js/highlight.pack.js?1661091037"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="/easymacro/js/modernizr.custom-3.6.0.js?1661091037"></script>
<script src="/easymacro/js/learn.js?1661091037"></script>
<script src="/easymacro/js/hugo-learn.js?1661091037"></script>
<script src="/easymacro/mermaid/mermaid.js?1661091037"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink