RayCraftDocs
v1.0.3
pt-BR
raycraft.dev
Nesta página

Spreadsheet

Complete

Uma planilha completa: fórmulas e funções, formatação, células mescladas, painéis congelados, gráficos, formatação condicional, validação de dados, várias planilhas, desfazer e refazer, copiar e colar, preencher, ordenar, localizar e substituir, e arquivos CSV, .xlsx e JSON. O mecanismo de fórmulas e o código de arquivos fazem parte do RayCraft.Blazor.Office e não têm partes de terceiros.

Parâmetros

Rules colour cells by their values. Rules are checked in order; when two rules set the same property, the first one wins. A Formula rule is written for the top-left cell of its range and applies to every cell relative to it.

ParâmetroTipoDescrição
RuleEffect
GreaterThan, GreaterOrEqual, LessThan, LessOrEqual, Equal, NotEqualColours cells that compare that way with the value (a number, text or =formula).
Between, NotBetweenColours cells inside or outside the two limits.
TextContains, TextNotContains, BeginsWith, EndsWithColours cells by their shown text, ignoring case.
Blank, NotBlank, ErrorColours empty cells, filled cells or cells showing an error.
Duplicate, UniqueColours values that appear more than once, or only once, in the range.
Top, BottomColours the highest or lowest numbers (default 10).
AboveAverage, BelowAverageColours numbers above or below the average of the range.
FormulaColours cells where the formula is true; references move with the cell.
ColorScaleFills numbers from one colour to another (Background = lowest, Color = highest, MidColor optional).
DataBarDraws a bar behind each number, as long as its share of the largest value (Background = bar colour).

Everything is reachable by keyboard and mouse, with the shortcuts people know from other spreadsheets.

ParâmetroTipoDescrição
Keys or gestureWhat it does
Arrow keys, Tab, EnterMove the active cell (Shift reverses Tab and Enter)
Shift + arrows / click / dragExtend the selection
Ctrl + arrowsJump to the edge of a block of filled cells
Ctrl + Home / EndGo to A1 / the last used cell
Home, End, PageUp, PageDownRow start or end, page up or down
Ctrl + A, Ctrl + Space, Shift + SpaceSelect everything, the column or the row
Type, F2, double-clickEdit the cell (typing replaces its content, F2 keeps it)
Enter / Tab / Esc while editingAccept and move down or right / cancel
Delete, BackspaceClear the selected cells
Ctrl + C, X, VCopy, cut and paste; formulas keep their relative references, and text from other programs is pasted as values
Ctrl + Z, Ctrl + YUndo and redo (also Ctrl + Shift + Z)
Ctrl + B, I, UBold, italic, underline
Ctrl + D, Ctrl + RFill the selection down or right from its first row or column
Ctrl + FFind and replace
Drag the fill handleCopy a cell, continue a number series (1, 2 gives 3, 4...) or count up text such as Item 1
Click a column or row headerSelect the whole column or row; drag across headers to select several
Drag a header edge, double-click itResize a column or row, or reset it
Right-click a cell, a column or row header, or a chartContext menu with the commands that fit what you clicked
Click a chart, drag it, drag its corner, DeleteSelect, move, resize and remove a chart
Arrow next to a cell with a list ruleOpen the drop-down and pick a value
Name box (top left)Type A1 or B2:D9 to jump to a cell or range
F7, cell with a coloured cornerSpelling and grammar panel; right-click a marked cell for its corrections

The menu bar above the toolbar groups every command. Click a menu name (or move to it with the arrow keys) to open it; Left and Right switch between menus, Up and Down move through the entries, Right opens a submenu and Escape closes the menu. Right-click opens a context menu that fits what you clicked: a cell, a column header, a row header or a chart.

ParâmetroTipoDescrição
MenuContents
FileImport a file; export as CSV, XLSX or JSON.
EditUndo, redo, cut, copy, paste, paste special (values or formatting only), select all, clear contents or formatting, find and replace.
ViewShow or hide the toolbar, formula bar, sheet tabs and status bar; freeze panes.
InsertRows and columns; open the chart, conditional formatting and data validation panels.
FormatBold, italic, underline, strikethrough; number format, alignment, wrap text, borders; merge cells; clear formatting.
DataSort, fill down and right, data validation, conditional formatting.
ReviewSpelling, grammar and formula checks.
SheetAdd, rename, delete and move the current sheet.

Operators and functions that take single values work on whole ranges and arrays, element by element: =SUMPRODUCT((A1:A5>2)*B1:B5), =SUM(IF(A1:A5>2,A1:A5,0)) or =TEXTJOIN(",",TRUE,IF(A1:A5>2,C1:C5,"")). A formula that produces several values (=A1:A5*2, =UPPER(C1:C5), =SORT(A1:A5), ={1,2,3}) fills the cells below or to the right and shows #SPILL! when one of them is not empty.

ParâmetroTipoDescrição
GroupFunctions
MathABSSIGNSQRTPOWEREXPLNLOGLOG10MODQUOTIENTINTTRUNCROUNDROUNDUPROUNDDOWNCEILINGFLOOREVENODDFACTGCDLCMPIRANDRANDBETWEENSINCOSTANASINACOSATANATAN2DEGREESRADIANSSUMPRODUCTSUMSQSUMPRODUCTSINHCOSHTANHSQRTPIMROUNDCOMBINPERMUTSUBTOTAL
StatisticsAVERAGEMINMAXMEDIANMODECOUNTCOUNTACOUNTBLANKLARGESMALLRANKVARVARPSTDEVSTDEVPSUMIFSUMIFSCOUNTIFCOUNTIFSAVERAGEIFAVERAGEIFSMAXIFSMINIFSAVERAGEAPERCENTILEQUARTILECORRELSLOPEINTERCEPTFORECASTGEOMEANHARMEANAGGREGATE
LogicIFIFSIFERRORIFNASWITCHANDORXORNOTTRUEFALSE
TextLENUPPERLOWERPROPERTRIMCLEANLEFTRIGHTMIDCONCATCONCATENATETEXTJOINREPTSUBSTITUTEREPLACEFINDSEARCHEXACTVALUETEXTCHARCODETNTEXTBEFORETEXTAFTERNUMBERVALUEUNICODEUNICHAR
LookupVLOOKUPHLOOKUPINDEXMATCHCHOOSEROWCOLUMNROWSCOLUMNSINDIRECTLOOKUPXLOOKUPXMATCHOFFSETADDRESS
Date and timeTODAYNOWDATETIMEYEARMONTHDAYHOURMINUTESECONDWEEKDAYEDATEEOMONTHDAYSDATEDIFWEEKNUMISOWEEKNUMNETWORKDAYSWORKDAYDATEVALUE
Dynamic arraysSEQUENCETRANSPOSEUNIQUESORTSORTBYFILTER
FinancialPMTFVPVNPERNPVIRRRATESLN
Number bases and numeralsBIN2DECOCT2DECHEX2DECDEC2BINDEC2OCTDEC2HEXBASEDECIMALROMANARABIC
InformationISNUMBERISTEXTISNONTEXTISLOGICALISBLANKISERRORISERRISNAISEVENISODDNAERROR.TYPE
DistributionsNORM.DISTNORM.INVNORM.S.DISTNORM.S.INVPHIGAUSSLOGNORM.DISTLOGNORM.INVEXPON.DISTPOISSON.DISTBINOM.DISTBINOM.INVHYPGEOM.DISTNEGBINOM.DISTT.DISTT.DIST.2TT.DIST.RTT.INVT.INV.2TCHISQ.DISTCHISQ.DIST.RTCHISQ.INVCHISQ.INV.RTGAMMA.DISTGAMMA.INVWEIBULL.DISTBETA.DISTBETA.INVCONFIDENCE.NORMCONFIDENCE.TZ.TESTSTANDARDIZEFISHERFISHERINVERFERFCGAMMAGAMMALN
More statisticsAVEDEVDEVSQSKEWSKEW.PKURTSTDEVASTDEVPAVARAVARPAMAXAMINATRIMMEANRSQPEARSONSTEYXCOVARCOVARIANCE.PCOVARIANCE.SPERCENTRANKPERCENTRANK.EXCPERCENTILE.EXCQUARTILE.EXCRANK.AVGFREQUENCYMODE.MULTLINESTTRENDFORECAST.LINEAR
More financialIPMTPPMTCUMIPMTCUMPRINCISPMTEFFECTNOMINALRRIPDURATIONMIRRXNPVXIRRFVSCHEDULEDBDDBSYDDOLLARDEDOLLARFRDAYS360YEARFRAC
DatabaseDSUMDAVERAGEDCOUNTDCOUNTADGETDMAXDMINDPRODUCTDSTDEVDSTDEVPDVARDVARP
More arraysTAKEDROPCHOOSECOLSCHOOSEROWSVSTACKHSTACKTOCOLTOROWWRAPROWSWRAPCOLSEXPANDTEXTSPLITRANDARRAYMMULTMINVERSEMDETERMMUNIT
More math and informationACOSHASINHATANHCOTCOTHCSCCSCHSECSECHACOTACOTHCEILING.MATHFLOOR.MATHCEILING.PRECISEFLOOR.PRECISEFACTDOUBLEMULTINOMIALSERIESSUMSUMX2MY2SUMX2PY2SUMXMY2BITANDBITORBITXORBITLSHIFTBITRSHIFTDELTAGESTEPCOMBINAPERMUTATIONATYPEISFORMULAFORMULATEXTISREFAREASCELLSHEETSHEETSHYPERLINKDOLLARFIXEDENCODEURLTIMEVALUEVALUETOTEXT
LambdaLETLAMBDAMAPREDUCESCANBYROWBYCOLMAKEARRAY
EngineeringNETWORKDAYS.INTLWORKDAY.INTLCONVERTCOMPLEXIMREALIMAGINARYIMABSIMARGUMENTIMCONJUGATEIMSUMIMSUBIMPRODUCTIMDIVIMPOWERIMSQRTIMEXPIMLNIMSINIMCOSBIN2HEXBIN2OCTHEX2BINHEX2OCTOCT2BINOCT2HEX
OtherBINOMDISTCHIDISTCHIINVCONFIDENCECRITBINOMERF.PRECISEERFC.PRECISEEXPONDISTFINDBGAMMADISTGAMMAINVGAMMALN.PRECISEHYPGEOMDISTMODE.SNGLNORMDISTNORMINVNORMSDISTNORMSINVPERCENTILE.INCPERCENTRANK.INCPOISSONQUARTILE.INCRANK.EQSEARCHBSTDEV.PSTDEV.STDISTTINVVAR.PVAR.SWEIBULLZTEST

=A1+B1*2

ParâmetroTipoDescrição
ErrorMeaning
#DIV/0!Division by zero.
#VALUE!A value has the wrong type, for example text where a number is needed.
#REF!A reference points to a cell that was deleted or to a sheet that does not exist.
#NAME?A function or name is not known.
#N/AA lookup found nothing.
#NUM!A number is not valid for the function, or the calculation is too deep.
#CIRC!The formula depends on itself.
#ERROR!The formula could not be understood.

API

ParâmetroTipoDescrição
AllowFileTransferboolMostra os comandos de importação e exportação (true por padrão).
AllowSheetChangesboolPermite adicionar, renomear e excluir planilhas (true por padrão).
ClassstringClasses CSS extras adicionadas ao elemento raiz.
FileNamestringNome dado aos arquivos exportados, sem extensão (workbook por padrão).
HeightstringAltura de todo o controle como comprimento CSS (34rem por padrão).
IgnoredWordsIReadOnlyCollection<string>Palavras que nunca são reportadas como erradas.
LabelstringNome acessível da grade. Por padrão, um Spreadsheet localizado.
MaxImportSizeInt64Maior arquivo que pode ser importado, em bytes (5.000.000 por padrão).
PdfFontsPdfFontSet
ProofAsYouTypeboolMarca as células com problemas conforme a planilha muda (planilhas de até 50.000 células preenchidas); o usuário pode ativar no menu Review.
ProofingboolVerifica ortografia, gramática, fórmulas, números e totais: menu Review, botão da barra de ferramentas e F7 (true por padrão).
ReadOnlyboolSem edição, mas selecionar, copiar e exportar continuam funcionando.
ShowFormulaBarboolMostra a caixa de nome e a barra de fórmulas (true por padrão).
ShowMenuBarboolMostra a barra de menus (true por padrão).
ShowSheetTabsboolMostra as guias das planilhas (true por padrão).
ShowStatusBarboolMostra a barra de status com Sum, Average, Count, Min e Max da seleção (true por padrão).
ShowToolbarboolMostra a barra de ferramentas de formatação e edição (true por padrão).
StylestringEstilo embutido adicionado ao elemento raiz.
WorkbookWorkbookOs dados a mostrar e editar. Omita para uma nova pasta de trabalho vazia (leia-a de volta com GetWorkbook()).

Eventos

API

EventoTipoDescrição
OnChangedEventCallbackGerado depois que a pasta de trabalho mudou: uma edição, desfazer ou refazer.
OnNewEventCallback
OnSaveEventCallback<OfficeFileSave>
OnSaveAsEventCallback<OfficeFileSave>
OnSelectionChangedEventCallback<CellRange>Gerado quando a seleção se moveu.

Pacote

Spreadsheet faz parte do RayCraft Complete. Pacote: RayCraft.Blazor.Complete. Vem do feed privado do RayCraft e requer uma licença ativa. Veja Primeiros passos.