Compartir a través de

Conjunto de requisitos de solo escritorio de la API de JavaScript de Excel 1.1

El ExcelApiDesktop conjunto de requisitos es un conjunto de requisitos especial que incluye características que solo están disponibles en Excel para Windows y Excel para Mac. Las API de este conjunto de requisitos se consideran API de producción para la aplicación de Excel en Windows y Mac. Siguen las directivas de soporte técnico para desarrolladores de Microsoft 365. ExcelApiDesktop Las API se consideran api de "versión preliminar" para otras plataformas (como web y iPad) y es posible que ninguna de esas plataformas sea compatible.

Cuando las API del ExcelApiDesktop conjunto de requisitos se admiten en todas las plataformas, se agregarán al siguiente conjunto de requisitos publicado (ExcelApi 1.[NEXT]). Una vez que el nuevo conjunto de requisitos sea público, esas API también seguirán etiquetadas en este ExcelApiDesktop conjunto de requisitos. Para más información sobre los requisitos específicos de la plataforma en general, consulte Descripción de los conjuntos de requisitos específicos de la plataforma.

Importante

ExcelApiDesktop 1.1 es un conjunto de requisitos de solo escritorio. Es un superconjunto de ExcelApi 1.20.

Dado que Excel solo admite las ExcelApiDesktop 1.1 API en Windows y Mac, el complemento debe comprobar si el conjunto de requisitos es compatible antes de llamar a estas API. Esto evita cualquier intento de usar API de solo escritorio en una plataforma no admitida.

if (Office.context.requirements.isSetSupported("ExcelApiDesktop", "1.1")) {
   // Any API exclusive to this ExcelApiDesktop requirement set.
}

Una vez que la API se encuentra en un conjunto de requisitos multiplataforma, debe quitar o editar la isSetSupported comprobación. Esto habilitará la característica del complemento en otras plataformas. Asegúrese de probar la característica en esas plataformas al realizar este cambio.

Importante

El manifiesto no se puede especificar ExcelApiDesktop 1.1 como requisito de activación. No es un valor válido para usar en el elemento Set.

Lista de API

En la tabla siguiente se enumeran las API de JavaScript de Excel incluidas actualmente en el conjunto de ExcelApiDesktop 1.1 requisitos. Para obtener una lista completa de todas las API de JavaScript de Excel (incluidas ExcelApiDesktop 1.1 las API y las API publicadas anteriormente), consulte todas las API de JavaScript de Excel.

Clase Campos Descripción
Application activeWindow Devuelve un window objeto que representa la ventana activa (la ventana de la parte superior).
checkSpelling(word: string, options?: Excel.CheckSpellingOptions) Comprueba la ortografía de un sola palabra.
enterEditingMode() Entra en modo de edición para el rango seleccionado en la hoja de cálculo activa.
union(firstRange: Range | RangeAreas, secondRange: Range | RangeAreas, ... additionalRanges: (Range | RangeAreas)[]) Devuelve un RangeAreas objeto que representa la unión de dos o más Range objetos o RangeAreas .
Windows Devuelve todas las ventanas abiertas de Excel.
CheckSpellingOptions customDictionary Opcional.
ignoreUppercase Opcional.
HeaderFooter centerFooterPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección central del pie de página.
centerHeaderPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección central del encabezado.
leftFooterPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección izquierda del pie de página.
leftHeaderPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección izquierda del encabezado.
rightFooterPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección derecha del pie de página.
rightHeaderPicture Obtiene un HeaderFooterPicture objeto que representa la imagen de la sección derecha del encabezado.
HeaderFooterPicture brillo Especifica el brillo de la imagen.
colorType Especifica el tipo de transformación de color de la imagen.
contraste Especifica el contraste de la imagen.
cropBottom Especifica el número de puntos que se recortan de la parte inferior de la imagen.
cropLeft Especifica el número de puntos recortados del lado izquierdo de la imagen.
cropRight Especifica el número de puntos que se recortan del lado derecho de la imagen.
cropTop Especifica el número de puntos que se recortan de la parte superior de la imagen.
Nombre Especifica la dirección URL (en la intranet o la web) o la ruta de acceso (local o de red) a la ubicación donde se guarda el objeto de origen.
height Especifica el alto de la imagen en puntos.
lockAspectRatio Especifica un valor que indica si la imagen conserva sus proporciones originales al cambiar el tamaño.
width Especifica el ancho de la imagen en puntos.
Image brillo Especifica el brillo de la imagen.
colorType Especifica el tipo de transformación de color aplicado a la imagen.
contraste Especifica el contraste de la imagen.
cropBottom Especifica el número de puntos que se recortan de la parte inferior de la imagen.
cropLeft Especifica el número de puntos recortados del lado izquierdo de la imagen.
cropRight Especifica el número de puntos recortados del lado derecho de la imagen.
cropTop Especifica el número de puntos que se recortan de la parte superior de la imagen.
incrementBrightness(increment: number) Incrementa el brillo de la imagen en una cantidad especificada.
incrementContrast(increment: number) Incrementa el contraste de la imagen en una cantidad especificada.
PageLayout alignMarginsHeaderFooter Especifica si Excel alinea el encabezado y el pie de página con los márgenes establecidos en las opciones de configuración de página.
printQuality Especifica una matriz de dos elementos que contiene valores de calidad de impresión horizontales y verticales.
Panel index Devuelve el índice del panel.
PaneCollection getCount() Devuelve el número de paneles de la colección.
getItemAt(index: number) Obtiene el panel de la colección por índice.
items Obtiene los elementos secundarios cargados en esta colección.
Rango checkSpelling(options?: Excel.CheckSpellingOptions) Comprueba la ortografía de las palabras de este intervalo.
formulaArray Especifica la fórmula de matriz de un intervalo.
showDependents(remove?: boolean) Dibuja flechas de rastreo a las celdas dependientes directas del rango.
showPrecedents(remove?: boolean) Dibuja flechas de rastreo a las celdas precedentes directas del rango.
Window activate() Activa la ventana.
activateNext() Activa la siguiente ventana.
activatePrevious() Activa la ventana anterior.
activeCell Obtiene la celda activa de la ventana.
activePane Obtiene el panel activo de la ventana.
activeWorksheet Obtiene la hoja de cálculo activa en la ventana.
autoFilterDateGroupingEnabled Especifica si la agrupación de fechas de Autofiltro está habilitada en la ventana.
close() Cierra la ventana.
enableResize Especifica si el cambio de tamaño está habilitado para la ventana.
freezePanes Especifica si los paneles están inmovilizados en la ventana.
height Especifica el alto de la ventana.
index Obtiene el índice de la ventana.
isVisible Especifica si la ventana está visible.
largeScroll(Down: number, Up: number, ToRight: number, ToLeft: number) Desplaza la ventana por varias páginas.
left Especifica la distancia, en puntos, desde el borde izquierdo de la pantalla del equipo hasta el borde izquierdo de la ventana.
name Especifica el nombre de la ventana.
newWindow() Abre una nueva ventana de Excel.
Paneles Obtiene una colección de paneles asociados a la ventana.
pointsToScreenPixelsX(Points: number) Convierte los puntos horizontales en píxeles de pantalla.
pointsToScreenPixelsY(Points: number) Convierte los puntos verticales en píxeles de pantalla.
scrollColumn Especifica la columna de desplazamiento de la ventana.
scrollIntoView(Left: number, Top: number, Width: number, Height: number, Start?: boolean) Desplaza la ventana para mostrar el intervalo especificado.
scrollRow Especifica la fila de desplazamiento de la ventana.
scrollWorkbookTabs(Sheets?: number, Position?: Excel.ScrollWorkbookTabPosition) Desplaza las pestañas del libro.
showFormulas Especifica si las fórmulas se muestran en la ventana.
showGridlines Especifica si las líneas de cuadrícula se muestran en la ventana.
showHeadings Especifica si los encabezados se muestran en la ventana.
showHorizontalScrollBar Especifica si la barra de desplazamiento horizontal se muestra en la ventana.
showOutline Especifica si el esquema se muestra en la ventana.
showRightToLeft Obtiene el valor de diseño de derecha a izquierda de la ventana.
showRuler Especifica si la regla se muestra en la ventana.
showVerticalScrollBar Especifica si la barra de desplazamiento vertical se muestra en la ventana.
showWhitespace Especifica si el espacio en blanco se muestra en la ventana.
showWorkbookTabs Especifica si las pestañas del libro se muestran en la ventana.
showZeros Especifica si se muestran ceros en la ventana.
smallScroll(Down: number, Up: number, ToRight: number, ToLeft: number) Desplaza la ventana por varias filas o columnas.
partir Especifica el estado de división de la ventana.
splitColumn Especifica la columna de división de la ventana.
splitHorizontal Especifica la división horizontal de la ventana.
splitRow Especifica la fila dividida de la ventana.
splitVertical Especifica la división vertical de la ventana.
tabRatio Especifica la relación de tabulación de la ventana.
top Especifica la distancia, en puntos, desde el borde superior de la ventana hasta el borde superior del área utilizable (debajo de los menús, las barras de herramientas acopladas en la parte superior y la barra de fórmulas).
type Especifica el tipo de la ventana.
usableHeight Obtiene el alto utilizable de la ventana.
usableWidth Obtiene el ancho utilizable de la ventana.
view Especifica la vista de la ventana.
visibleRange Obtiene el intervalo visible de la ventana.
width Especifica el ancho de visualización de la ventana.
windowNumber Obtiene el número de ventana.
windowState Especifica el estado de la ventana.
zoom Especifica un valor entero que representa el tamaño de visualización de la ventana.
WindowCollection breakSideBySide() Interrumpe la vista en paralelo de las ventanas.
compareCurrentSideBySideWith(windowName: string) Compara la ventana actual en paralelo con la ventana especificada.
getCount() Obtiene el número de ventanas de la colección.
getItemAt(index: number) Obtiene la ventana de la colección por índice.
items Obtiene los elementos secundarios cargados en esta colección.
resetPositionsSideBySide() Restablece las posiciones de las ventanas en la vista en paralelo.
Workbook focus() Establece el foco en el libro.
Worksheet checkSpelling(options?: Excel.CheckSpellingOptions) Comprueba la ortografía de las palabras de esta hoja de cálculo.
clearArrows() Borra las flechas de rastreo de la hoja de cálculo.
evaluate(name: string) Devuelve el resultado de evaluación de una cadena de fórmula.

Vea también

  • Last updated on