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 especiales 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 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 no sean compatibles con ninguna de esas plataformas.

Cuando las API del conjunto de ExcelApiDesktop requisitos sean compatibles con 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 etiquetándose en este ExcelApiDesktop conjunto de requisitos. Para obtener 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 solo para escritorio. Es un superconjunto de ExcelApi 1.21.

Dado que las ExcelApiDesktop 1.1 API solo son compatibles con Excel 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 solo de escritorio en una plataforma no compatible.

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

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

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 las ExcelApiDesktop 1.1 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 el modo de edición para el rango seleccionado en la hoja de cálculo activa.
union(firstRange: Range | RangeAreas, secondRange: Rango | RangeAreas, ... additionalRanges: (Range | RangeAreas)[]) Devuelve un RangeAreas objeto que representa la unión de dos o más RangeRangeAreas objetos.
Windows Devuelve todas las ventanas de Excel abiertas.
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.
tipo de color Especifica el tipo de transformación del color de la imagen.
de contraste Especifica el contraste de la imagen.
cropBottom Especifica el número de puntos recortados 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 recortados de la parte superior de la imagen.
nombre de archivo Especifica la dirección URL (en la intranet o en la web) o la ruta de acceso (local o de red) a la ubicación donde se guarda el objeto de origen.
height Especifica la altura 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.
tipo de color Especifica el tipo de transformación del color que se aplica a la imagen.
de 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 que se recortan 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 recortados de la parte superior de la imagen.
incrementBrightness(increment: number) Incrementa el brillo de la imagen en una cantidad especificada.
incrementContrast(incremento: número) 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.
PanelCollection 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) Revisa la ortografía de las palabras de este intervalo.
Matriz de fórmulas Especifica la fórmula de matriz de un rango.
showDependents(remove?: boolean) Dibuja flechas de rastreo a las celdas dependientes directas del rango.
showPrecedents(¿eliminar?: 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 en la ventana.
ActivePane Obtiene el panel activo de la ventana.
hoja de trabajo activa Obtiene la hoja de cálculo activa en la ventana.
autoFilterDateGroupingEnabled Especifica si la agrupación de fechas Autofiltro está habilitada en la ventana.
close() Cierra la ventana.
enableResize Especifica si está habilitado el cambio de tamaño para la ventana.
freezePanes Especifica si los paneles están inmovilizados en la ventana.
height Especifica la altura 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 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() Se 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 puntos verticales en píxeles de pantalla.
scrollColumn Especifica la columna de desplazamiento de la ventana.
scrollIntoView(Izquierda: número, Superior: número, Ancho: número, Alto: número, Inicio?: booleano) Desplaza la ventana para mostrar el intervalo especificado.
scrollRow Especifica la fila de desplazamiento de la ventana.
scrollWorkbookTabs(Sheets?: number, Position?: Excel.ScrollWorkbookTabPosition) Se desplaza por 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 se muestran los títulos en la ventana.
showHorizontalScrollBar Especifica si la barra de desplazamiento horizontal se muestra en la ventana.
showOutline Especifica si se muestra el esquema en la ventana.
showRightToLeft Obtiene el valor de diseño de la ventana de derecha a izquierda.
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 se muestra el espacio en blanco en la ventana.
showWorkbookTabs Especifica si se muestran pestañas de libro 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.
dividir Especifica el estado de división de la ventana.
splitColumn Especifica la columna dividida de la ventana.
dividirHorizontal 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 proporción de tabulaciones 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 ventana.
usableHeight Obtiene la altura utilizable de la ventana.
usableWidth Obtiene el ancho utilizable de la ventana.
view Especifica la vista de la ventana.
visibleRange Obtiene el rango visible de la ventana.
width Especifica el ancho de visualización de la ventana.
windowNumber Obtiene el número de la 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() Rompe 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 enfoque() Establece el foco en el libro.
Worksheet checkSpelling(options?: Excel.CheckSpellingOptions) Revisa la ortografía de las palabras de esta hoja de cálculo.
clearArrows() Borra las flechas de rastreo de la hoja de cálculo.
evaluar(nombre: cadena) Devuelve el resultado de la evaluación de una cadena de fórmula.

Vea también

  • Last updated on