Excel.Window class
Représente une fenêtre dans le classeur.
- Extends
Propriétés
| active |
Spécifie la cellule active dans la fenêtre. |
| active |
Spécifie le volet actif dans la fenêtre. |
| active |
Spécifie la feuille active dans la fenêtre. |
| auto |
Spécifie si le regroupement de dates AutoFilter est activé dans la fenêtre. |
| context | Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office. |
| enable |
Indique si le redimensionnement est activé pour la fenêtre. |
| freeze |
Indique si les volets sont figés dans la fenêtre. |
| height | Spécifie la hauteur de la fenêtre. |
| index | Récupère l’index de la fenêtre. |
| is |
Indique si la fenêtre est visible. |
| left | Spécifie la distance, en points, entre le bord gauche de l’écran de l’ordinateur et le bord gauche de la fenêtre. |
| name | Spécifie le nom de la fenêtre. |
| panes | Obtient une collection de volets associés à la fenêtre. |
| range |
Obtient la sélection de plage dans la fenêtre. |
| scroll |
Spécifie la colonne de défilement de la fenêtre. |
| scroll |
Spécifie la ligne de défilement de la fenêtre. |
| show |
Indique si les formules sont affichées dans la fenêtre. |
| show |
Indique si le quadrillage s’affiche dans la fenêtre. |
| show |
Indique si les titres sont affichés dans la fenêtre. |
| show |
Indique si la barre de défilement horizontale est affichée dans la fenêtre. |
| show |
Indique si le contour est affiché dans la fenêtre. |
| show |
Obtient la valeur de disposition de droite à gauche de la fenêtre. True signifie que la fenêtre est disposée de droite à gauche, false signifie que la fenêtre est disposée de gauche à droite. |
| show |
Indique si la règle est affichée dans la fenêtre. |
| show |
Indique si la barre de défilement verticale est affichée dans la fenêtre. |
| show |
Indique si un espace blanc est affiché dans la fenêtre. |
| show |
Indique si les onglets de classeur sont affichés dans la fenêtre. |
| show |
Indique si des zéros sont affichés dans la fenêtre. |
| split | Spécifie l’état de fractionnement de la fenêtre. |
| split |
Spécifie le fractionnement de colonne de la fenêtre. |
| split |
Spécifie le fractionnement horizontal de la fenêtre. |
| split |
Spécifie le fractionnement de ligne de la fenêtre. |
| split |
Spécifie le fractionnement vertical de la fenêtre. |
| tab |
Spécifie les proportions de tabulation de la fenêtre. |
| top | Spécifie la distance, en points, entre le bord supérieur de la fenêtre et le bord supérieur de la zone utilisable (sous les menus, les barres d’outils ancrées en haut et la barre de formule). |
| type | Spécifie le type de fenêtre. |
| usable |
Spécifie la hauteur utile de la fenêtre. |
| usable |
Spécifie la largeur utile de la fenêtre. |
| view | Spécifie la vue de la fenêtre. |
| visible |
Récupère la plage visible de la fenêtre. |
| width | Spécifie la largeur d’affichage de la fenêtre. |
| window |
Obtient le numéro de fenêtre. |
| window |
Spécifie l’état de la fenêtre. |
| zoom | Spécifie un nombre entier qui représente la taille d’affichage de la fenêtre. Il peut être défini sur un pourcentage compris entre 10 et 400. |
Méthodes
| activate() | Active la fenêtre. |
| activate |
Active la fenêtre suivante. |
| activate |
Active la fenêtre précédente. |
| close() | Ferme la fenêtre. |
| large |
Défile la fenêtre de plusieurs pages. Les |
| load(options) | Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| new |
Ouvre une nouvelle fenêtre Excel. |
| points |
Convertit les points horizontaux en pixels d’écran. |
| points |
Convertit les points verticaux en pixels d’écran. |
| scroll |
Fait défiler la fenêtre pour afficher la plage spécifiée. |
| scroll |
Fait défiler les onglets du classeur. |
| scroll |
Fait défiler les onglets du classeur. |
| set(properties, options) | Définit plusieurs propriétés d’un objet en même temps. Vous pouvez transmettre soit un objet ordinaire avec les propriétés appropriées, soit un autre objet API du même type. |
| set(properties) | Définit plusieurs propriétés sur l’objet en même temps, en fonction d’un objet chargé existant. |
| small |
Fait défiler la fenêtre d’un certain nombre de lignes ou de colonnes. Les |
| toJSON() | Remplace la méthode JavaScript |
Détails de la propriété
activeCell
Spécifie la cellule active dans la fenêtre.
readonly activeCell: Excel.Range;Valeur de propriété
Remarques
activePane
Spécifie le volet actif dans la fenêtre.
readonly activePane: Excel.Pane;Valeur de propriété
Remarques
activeWorksheet
Spécifie la feuille active dans la fenêtre.
readonly activeWorksheet: Excel.Worksheet;Valeur de propriété
Remarques
autoFilterDateGroupingEnabled
Spécifie si le regroupement de dates AutoFilter est activé dans la fenêtre.
autoFilterDateGroupingEnabled: boolean;Valeur de propriété
boolean
Remarques
context
Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office.
context: RequestContext;Valeur de propriété
enableResize
Indique si le redimensionnement est activé pour la fenêtre.
readonly enableResize: boolean;Valeur de propriété
boolean
Remarques
freezePanes
Indique si les volets sont figés dans la fenêtre.
freezePanes: boolean;Valeur de propriété
boolean
Remarques
height
Spécifie la hauteur de la fenêtre.
height: number;Valeur de propriété
number
Remarques
index
Récupère l’index de la fenêtre.
readonly index: number;Valeur de propriété
number
Remarques
isVisible
Indique si la fenêtre est visible.
isVisible: boolean;Valeur de propriété
boolean
Remarques
left
Spécifie la distance, en points, entre le bord gauche de l’écran de l’ordinateur et le bord gauche de la fenêtre.
left: number;Valeur de propriété
number
Remarques
name
Spécifie le nom de la fenêtre.
name: string;Valeur de propriété
string
Remarques
panes
Obtient une collection de volets associés à la fenêtre.
readonly panes: Excel.PaneCollection;Valeur de propriété
Remarques
rangeSelection
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la sélection de plage dans la fenêtre.
readonly rangeSelection: Excel.RangeAreas;Valeur de propriété
Remarques
scrollColumn
Spécifie la colonne de défilement de la fenêtre.
scrollColumn: number;Valeur de propriété
number
Remarques
scrollRow
Spécifie la ligne de défilement de la fenêtre.
scrollRow: number;Valeur de propriété
number
Remarques
showFormulas
Indique si les formules sont affichées dans la fenêtre.
showFormulas: boolean;Valeur de propriété
boolean
Remarques
showGridlines
Indique si le quadrillage s’affiche dans la fenêtre.
showGridlines: boolean;Valeur de propriété
boolean
Remarques
showHeadings
Indique si les titres sont affichés dans la fenêtre.
showHeadings: boolean;Valeur de propriété
boolean
Remarques
showHorizontalScrollBar
Indique si la barre de défilement horizontale est affichée dans la fenêtre.
showHorizontalScrollBar: boolean;Valeur de propriété
boolean
Remarques
showOutline
Indique si le contour est affiché dans la fenêtre.
showOutline: boolean;Valeur de propriété
boolean
Remarques
showRightToLeft
Obtient la valeur de disposition de droite à gauche de la fenêtre. True signifie que la fenêtre est disposée de droite à gauche, false signifie que la fenêtre est disposée de gauche à droite.
readonly showRightToLeft: boolean;Valeur de propriété
boolean
Remarques
showRuler
Indique si la règle est affichée dans la fenêtre.
showRuler: boolean;Valeur de propriété
boolean
Remarques
showVerticalScrollBar
Indique si la barre de défilement verticale est affichée dans la fenêtre.
showVerticalScrollBar: boolean;Valeur de propriété
boolean
Remarques
showWhitespace
Indique si un espace blanc est affiché dans la fenêtre.
showWhitespace: boolean;Valeur de propriété
boolean
Remarques
showWorkbookTabs
Indique si les onglets de classeur sont affichés dans la fenêtre.
showWorkbookTabs: boolean;Valeur de propriété
boolean
Remarques
showZeros
Indique si des zéros sont affichés dans la fenêtre.
showZeros: boolean;Valeur de propriété
boolean
Remarques
split
Spécifie l’état de fractionnement de la fenêtre.
split: boolean;Valeur de propriété
boolean
Remarques
splitColumn
Spécifie le fractionnement de colonne de la fenêtre.
splitColumn: number;Valeur de propriété
number
Remarques
splitHorizontal
Spécifie le fractionnement horizontal de la fenêtre.
splitHorizontal: number;Valeur de propriété
number
Remarques
splitRow
Spécifie le fractionnement de ligne de la fenêtre.
splitRow: number;Valeur de propriété
number
Remarques
splitVertical
Spécifie le fractionnement vertical de la fenêtre.
splitVertical: number;Valeur de propriété
number
Remarques
tabRatio
Spécifie les proportions de tabulation de la fenêtre.
tabRatio: number;Valeur de propriété
number
Remarques
top
Spécifie la distance, en points, entre le bord supérieur de la fenêtre et le bord supérieur de la zone utilisable (sous les menus, les barres d’outils ancrées en haut et la barre de formule).
top: number;Valeur de propriété
number
Remarques
type
Spécifie le type de fenêtre.
readonly type: Excel.WindowType | "chartAsWindow" | "chartInPlace" | "clipboard" | "workbook";Valeur de propriété
Excel.WindowType | "chartAsWindow" | "chartInPlace" | "clipboard" | "workbook"
Remarques
usableHeight
Spécifie la hauteur utile de la fenêtre.
readonly usableHeight: number;Valeur de propriété
number
Remarques
usableWidth
Spécifie la largeur utile de la fenêtre.
readonly usableWidth: number;Valeur de propriété
number
Remarques
view
Spécifie la vue de la fenêtre.
view: Excel.WindowView | "normalView" | "pageBreakPreview" | "pageLayoutView";Valeur de propriété
Excel.WindowView | "normalView" | "pageBreakPreview" | "pageLayoutView"
Remarques
visibleRange
Récupère la plage visible de la fenêtre.
readonly visibleRange: Excel.Range;Valeur de propriété
Remarques
width
Spécifie la largeur d’affichage de la fenêtre.
width: number;Valeur de propriété
number
Remarques
windowNumber
Obtient le numéro de fenêtre.
readonly windowNumber: number;Valeur de propriété
number
Remarques
windowState
Spécifie l’état de la fenêtre.
windowState: Excel.WindowState | "maximized" | "minimized" | "normal";Valeur de propriété
Excel.WindowState | "maximized" | "minimized" | "normal"
Remarques
zoom
Spécifie un nombre entier qui représente la taille d’affichage de la fenêtre. Il peut être défini sur un pourcentage compris entre 10 et 400.
zoom: number;Valeur de propriété
number
Remarques
Détails de la méthode
activate()
activateNext()
Active la fenêtre suivante.
activateNext(): void;Retours
void
Remarques
activatePrevious()
Active la fenêtre précédente.
activatePrevious(): void;Retours
void
Remarques
close()
Ferme la fenêtre.
close(): OfficeExtension.ClientResult<boolean>;Retours
OfficeExtension.ClientResult<boolean>
Remarques
largeScroll(Down, Up, ToRight, ToLeft)
Défile la fenêtre de plusieurs pages. Les downparamètres , toRightup, et toLeft correspondent à l’action de défilement avec les touches Page suivante, Page précédente, Alt+Page suivante et Alt+Page haut du clavier.
largeScroll(Down: number, Up: number, ToRight: number, ToLeft: number): void;Paramètres
- Down
-
number
- Up
-
number
- ToRight
-
number
- ToLeft
-
number
Retours
void
Remarques
load(options)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(options?: Excel.Interfaces.WindowLoadOptions): Excel.Window;Paramètres
Fournit des options pour les propriétés de l’objet à charger.
Retours
load(propertyNames)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(propertyNames?: string | string[]): Excel.Window;Paramètres
- propertyNames
-
string | string[]
Chaîne délimitée par des virgules ou tableau de chaînes spécifiant les propriétés à charger.
Retours
load(propertyNamesAndPaths)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.Window;Paramètres
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.
Retours
newWindow()
Ouvre une nouvelle fenêtre Excel.
newWindow(): Excel.Window;Retours
Remarques
pointsToScreenPixelsX(Points)
Convertit les points horizontaux en pixels d’écran.
pointsToScreenPixelsX(Points: number): OfficeExtension.ClientResult<number>;Paramètres
- Points
-
number
Retours
OfficeExtension.ClientResult<number>
Remarques
pointsToScreenPixelsY(Points)
Convertit les points verticaux en pixels d’écran.
pointsToScreenPixelsY(Points: number): OfficeExtension.ClientResult<number>;Paramètres
- Points
-
number
Retours
OfficeExtension.ClientResult<number>
Remarques
scrollIntoView(Left, Top, Width, Height, Start)
Fait défiler la fenêtre pour afficher la plage spécifiée.
scrollIntoView(Left: number, Top: number, Width: number, Height: number, Start?: boolean): void;Paramètres
- Left
-
number
- Top
-
number
- Width
-
number
- Height
-
number
- Start
-
boolean
Retours
void
Remarques
scrollWorkbookTabs(Sheets, Position)
Fait défiler les onglets du classeur.
scrollWorkbookTabs(Sheets?: number, Position?: Excel.ScrollWorkbookTabPosition): void;Paramètres
- Sheets
-
number
- Position
- Excel.ScrollWorkbookTabPosition
Retours
void
Remarques
scrollWorkbookTabs(Sheets, Position)
Fait défiler les onglets du classeur.
scrollWorkbookTabs(Sheets?: number, Position?: "First" | "Last"): void;Paramètres
- Sheets
-
number
- Position
-
"First" | "Last"
Retours
void
Remarques
set(properties, options)
Définit plusieurs propriétés d’un objet en même temps. Vous pouvez transmettre soit un objet ordinaire avec les propriétés appropriées, soit un autre objet API du même type.
set(properties: Interfaces.WindowUpdateData, options?: OfficeExtension.UpdateOptions): void;Paramètres
- properties
- Excel.Interfaces.WindowUpdateData
Objet JavaScript dont les propriétés sont structurées de façon isomorphe par rapport aux propriétés de l’objet sur lequel la méthode est appelée.
- options
- OfficeExtension.UpdateOptions
Fournit une option permettant de supprimer les erreurs si l’objet de propriétés tente de définir des propriétés en lecture seule.
Retours
void
set(properties)
Définit plusieurs propriétés sur l’objet en même temps, en fonction d’un objet chargé existant.
set(properties: Excel.Window): void;Paramètres
- properties
- Excel.Window
Retours
void
smallScroll(Down, Up, ToRight, ToLeft)
Fait défiler la fenêtre d’un certain nombre de lignes ou de colonnes. Les downparamètres , ,uptoRight , et toLeft correspondent à l’action de défilement avec les touches fléchées sur le clavier.
smallScroll(Down: number, Up: number, ToRight: number, ToLeft: number): void;Paramètres
- Down
-
number
- Up
-
number
- ToRight
-
number
- ToLeft
-
number
Retours
void
Remarques
toJSON()
Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine Excel.Window est un objet API, la toJSON méthode renvoie un objet JavaScript simple (typé ) Excel.Interfaces.WindowDataqui contient des copies superficielles de toutes les propriétés enfants chargées à partir de l’objet d’origine.
toJSON(): Excel.Interfaces.WindowData;