Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

LeftBorder - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Bordure de paragraphe à gauche. Lorsque l'objet est sérialisé en XML, son nom complet est w:left.

Espace de noms :  DocumentFormat.OpenXml.Wordprocessing
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class LeftBorder : BorderType

[ISO/IEC 29500-1 1st Edition]

left (Left Paragraph Border)

Cet élément spécifie la bordure qui doit s'afficher sur le côté gauche de la page autour du paragraphe spécifié. Cela ne change pas en fonction de l'orientation des paragraphes.

Pour déterminer si les deux paragraphes adjacents doivent avoir une bordure gauche qui s'étend sur la hauteur de ligne complet ou non, la bordure gauche est établie entre la bordure supérieure ou entre la bordure du haut (selon ce qui est rendu pour le paragraphe actuel) et la bordure inférieure ou entre la bordure du bas (selon ce qui est rendu pour le paragraphe actuel).

Si cet élément est omis sur un paragraphe donné, sa valeur est déterminée par le paramétrage défini précédemment à n'importe quel niveau de la hiérarchie de style (par exemple, ce paramètre précédent reste inchangé). Si ce paramètre n'est jamais spécifié dans la hiérarchie de style, aucune bordure gauche n'est applicable.

[Exemple: définition de WordprocessingML deux paragraphes suivants de prendre en compte :

<w:p>
  <w:pPr>
    <w:pBdr>
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" /> 
      <w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" /> 
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" /> 
    </w:pBdr>
  </w:pPr>
  <w:r>
    <w:t>First paragraph.</w:t> 
  </w:r>
</w:p>
<w:p>
  <w:pPr>
    <w:pBdr>
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" /> 
      <w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" /> 
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" /> 
    </w:pBdr>
  </w:pPr>
  <w:r>
    <w:t>Second paragraph.</w:t> 
  </w:r>
</w:p>

Étant donné que le jeu de bordure de paragraphe est identique entre les deux paragraphes, les paragraphes sont connectés par un entre la bordure. Ces paragraphes dessiner par conséquent la bordure gauche entre le haut et les bordures pour le premier paragraphe et entre et en bas des bordures pour le deuxième paragraphe. exemple de fin]

Éléments parents

pBdr (§17.3.1.24)

Modèle de contenu de cet élément est défini par la définition de propriétés de bordure commune dans §17.3.4.

[ISO/IEC 29500-1 1st Edition]

left (Left Border)

Cet élément spécifie la présentation et l'affichage de la bordure de la page affichée à gauche de chaque page de cette section.

[Exemple: envisager une section dans laquelle toutes les pages ont une bordure gauche consistant en une image répétée d'un parapluie, comme suit :

Cette bordure aurait pour résultat le schéma WordprocessingML suivant :

<w:sectPr>
  …  <w:pgBorders>
    <w:left w:val="seattle" …/>
  </w:pgBorders>
  …</w:sectPr>

Étant donné que la page comporte uniquement une bordure à gauche, seulement l'élément de gauche est spécifié dans l'ensemble des bordures de page. exemple de fin]

Lorsqu'un document a une bordure gauche est fonction des bords de page (à l'aide de la valeur de l'attribut offsetFrom de page sur pgBorders), il doit s'étendre sur le bord gauche de la page à l'emplacement défini par ses propriétés, arrêter lorsque :

  • Il croise le haut correspondant ou d'une bordure en bas de la page (s'il est spécifié).

  • Il atteint le bord de la page.

[Exemple: dans l'exemple ci-dessus, aucune bordure supérieure ou inférieure a été spécifié dans le schéma WordprocessingML, un consommateur doit dessiner la bordure d'un bord de la page à l'autre. exemple de fin]

Lorsqu'un document a une bordure gauche par rapport au texte (à l'aide de la valeur de l'attribut offsetFrom du texte sur pgBorders), elle doit couvrir uniquement la largeur nécessaire pour satisfaire à l'obligation de s'étendant sur la largeur du texte.

Lorsqu'un document a bordure spéciale personnalisée spécifiée par l'attribut d'id, elle doit utiliser l'élément de partie de relation correspondant sous la forme d'une image pour la bordure gauche. Si l'élément de partie de relation correspondant n'est trouvé, le consommateur doit utiliser la bordure spécifiée par la valeur de l'attribut de val. Si la valeur de l'attribut val correspondante ne peut pas être résolue, aucune bordure gauche n'est présent lorsque la page est affichée.

Éléments parents

pgBorders (§17.6.10)

Attributs

Description

couleurs (bordure)

Spécifie la couleur de cette bordure.

Cette valeur peut être définie en tant que :

  • Une valeur de couleur à l'aide de la palette de couleurs dont les valeurs rouges, verts et bleus sont écrits sous forme de nombres de la plage de 0 à 255, hexadécimal codé et concaténés. [Exemple: intensité complète rouge serait rouge 255, 0 vert, bleu, codé à FF, 00, 00, puis est concaténée à FF0000. exemple de fin] . les couleurs sont spécifiées dans l'espace de couleurs sRGB.

  • automatique pour permettre à un consommateur déterminer automatiquement la couleur de la bordure afin de faciliter la lecture du texte du document. [Exemple: un document avec du texte blanc et une couleur d'arrière-plan de auto peut entraîner l'utilisation d'un arrière-plan noir, afin d'assurer la lisibilité du contenu. exemple de fin]

[Exemple: pensez à une couleur de bordure avec la valeur automatique, comme suit :

<w:bottom … w:color="auto"/>

Cette couleur par conséquent peut être automatiquement modifiée par un consommateur selon le cas, par exemple, afin de garantir que la bordure peut être distinguée par rapport à la couleur d'arrière-plan de la page. exemple de fin]

Si le style de bordure (l'attribut val) spécifie l'utilisation d'une bordure art, cet attribut est ignoré. Ainsi, si la bordure indique l'utilisation d'une couleur de thème via l'attribut themeColor, cette valeur est remplacée par la valeur de couleur de thème.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_HexColor (§17.18.38).

cadre (effet de trame créer)

Spécifie si la bordure spécifiée doit être modifiée pour créer un effet de trame en inversant l'apparence de la bordure du bord le plus proche du texte sur le bord le plus éloigné du texte.

Si cet attribut est omis, la bordure n'est pas attribuée un effet d'image.

[Exemple: envisager une bordure inférieure qui doit apparaître avec un effet d'image, qui est spécifié dans le schéma WordprocessingML suivant :

<w:bottom w:frame="true" … />

Val de cette image est true, indique que l'effet de trame de bordure doit être appliquée. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_OnOff (§22.9.2.7).

ID (personnalisé défini bordure relation de référence)

Espace de noms : .../officeDocument/2006/relationships

Spécifie l'ID de relation pour la relation qui contient l'image de bordure personnalisée pour l'élément parent. Cette image de bordure personnalisée est contenue dans une partie distincte dans le package de WordprocessingML.

La relation ciblée de manière explicite par cet attribut doit être de type http://schemas.openxmlformats.org/officeDocument/2006/relationships/image ou le document est considéré comme non conforme.

Si cet attribut est omis, aucune bordure personnalisée ne doit être utilisée.

[Exemple: considérez le balisage WordprocessingML suivant pour une bordure personnalisée en bas d'un document :

<w:bottom w:val="custom" r:id="rIdCustomBottomBorder" …/>

L'attribut id dans l'espace de noms de référence de relation spécifie que la relation avec l' ID de relation rIdCustomBottomBorder doit contenir l'image de bordure personnalisée en bas du document. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_RelationshipId (§22.8.2.1).

ombre (ombre de bordure)

Spécifie si cette bordure doit être modifiée pour créer l'apparence d'une ombre.

Pour les bordures droite et inférieure, cela en dupliquant la bordure au-dessous et à droite de l'emplacement de bordure normale. Pour les bordures de droite et de haut, cela en déplaçant la commande vers le bas et à droite de son emplacement d'origine.

Si cet attribut est omis, la bordure est donnée pas l'effet d'ombre.

[Exemple: envisager une bordure supérieure, qui doit apparaître avec un effet d'ombre, ce qui entraîne le schéma WordprocessingML suivant :

<w:bottom w:shadow="true" … />

Val de cette image est true, indique que l'effet d'ombre doit être appliqué à la bordure. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_OnOff (§22.9.2.7).

espace (mesure l'espacement de la bordure)

Spécifie le décalage de l'espacement doit être utilisé pour placer cette bordure sur l'objet parent.

Lorsqu'un document a une bordure de page qui est fonction des bords de page (à l'aide de la page la valeur dans l'attribut offsetFrom sur pgBorders (§17.6.10)), elle indique la distance entre le bord de la page et le début de cette bordure en points.

Lorsqu'un document a une bordure de page par rapport à l'étendue de texte (à l'aide d'une valeur de texte dans l'attribut offsetFrom sur pgBorders (§17.6.10)), ou tout autre type de bordure, elle indique la distance entre le bord de l'objet et le début de cette bordure en points.

[Exemple: pensez à un document avec un jeu de toutes les bordures de page spécifié apparaissent 24 points entre le bord de la page. Le schéma WordprocessingML qui en résulte se présente comme suit :

<w:pgBorders w:offsetFrom="page">
  <w:bottom … w:space="24" /> 
</w:pgBorders

L'attribut offsetFrom indique que la valeur d'espace fournit l'offset de la bordure de page à partir du bord de la page, et la valeur de l'attribut espace Spécifie que le décalage de page doit être de 24 points. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_PointMeasure (§17.18.68).

sz (largeur de bordure)

Spécifie la largeur de la bordure en cours.

Si le style de bordure (attribut val) spécifie une bordure de ligne, l'épaisseur de cette bordure est spécifiée dans les mesures de huitièmes d'un point, avec une valeur minimale de deux (un quart d'un point) et une valeur maximale de 96 (12 points). Toutes les valeurs en dehors de cette plage peuvent être réaffectées à une valeur plus appropriée.

Si le style de bordure (attribut val) spécifie une bordure clipart, l'épaisseur de cette bordure est spécifiée dans les mesures des points, avec une valeur minimale et une valeur maximale de 31. Toutes les valeurs en dehors de cette plage peuvent être réaffectées à une valeur plus appropriée.

[Exemple: considérer un document avec une bordure en pointillé large trois points sur tous les côtés, entraînant le balisage WordprocessingML suivant :

<w:top w:val="dashed" w:sz="24" …/>
<w:left w:val="dashed" w:sz="24" …/>
<w:bottom w:val="dashed" w:sz="24" …/>
<w:right w:val="dashed" w:sz="24" …/>

Le style de bordure est spécifié à l'aide de l'attribut de val, et étant donné que ce style de bordure est une bordure de ligne (tirets), l'attribut sz spécifie la taille en huitièmes d'un point (24 huitièmes d'un point = 3 points). exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_EighthPointMeasure (§17.18.23).

themeColor (couleur de thème de bordure)

Spécifie la couleur de thème de base utilisée pour générer la couleur de la bordure. La couleur de la bordure est la valeur associée themeColor plus précisément transformé par themeTint ou themeShade (le cas échéant), sinon la couleur d'arrière-plan est la valeur associée themeColor.

La couleur de thème spécifié est une référence à l'une des couleurs de thème prédéfini, que qui se trouve dans thème partie du document (§14.2.7 et §20.1.6.9), qui permet des informations de couleur être définies de manière centralisée dans le document.

Pour déterminer la couleur à afficher, les actions suivantes sont exécutées :

  • En utilisant le mappage spécifié dans le type simple ST_ThemeColor (§17.18.97), l'attribut approprié à l'élément clrSchemeMapping (§17.15.1.20) est en lecture.

  • À l'aide de cette valeur et le mappage spécifié dans le type simple ST_ColorSchemeIndex (§17.18.103), l'élément approprié dans le cadre du thème du document est lu pour obtenir la couleur de thème de base.

  • La couleur spécifiée est modifiée en fonction de la présence de l'attribut themeTint ou themeShade.

[Exemple: pensez à un jeu de bordures configuré pour utiliser la couleur de thème accent2 résultant dans le balisage de WordprocessingML suivant :

<w:top … w:themeColor="accent2" w:themeTint="99" />
<w:bottom … w:themeColor="accent2" w:themeTint="99" />
<w:left … w:themeColor="accent2" w:themeTint="99" />
<w:right … w:themeColor="accent2" w:themeTint="99" />

Si la partie paramètres de contenu le balisage suivant :

<w:clrSchemeMapping … w:accent2="accent2"/>

et la partie thème contenue le balisage XML suivant :

<a:accent2>
  <a:srgbClr val="4F81BD"/>
</a:accent2>

la couleur de la bordure qui en résulte est 95B3D7 (le résultat d'une teinte de 60 % est appliquée à la couleur de thème d'origine ; consultez les calculs dans la themeTint ci-dessous pour plus de détails). exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_ThemeColor (§17.18.97).

themeShade (nuance de couleur de thème de bordure)

Spécifie la valeur de teinte appliquée à la couleur du thème fourni (le cas échéant) pour cette instance de bordure. Si l'attribut themeColor n'est pas présent, cet attribut ne doit pas être utilisé.

Si le themeShade est fournie, puis il est appliqué à la valeur de la couleur de thème (à partir de la partie de thème) pour déterminer la couleur finale appliquée à cette bordure.

La valeur themeShade est stockée sous la forme d'un hex de codage de la valeur de teinte (de 0 – 255) appliqué à la bordure en cours.

[Exemple: pensez à une nuance de 40 % est appliquée à une bordure dans un document. Cette nuance est calculée comme suit :

La valeur de themeShade résultant dans le format de fichier serait 66. exemple de fin]

Étant donné une couleur est définie comme trois valeurs hexadécimales au format RRGGBB, la nuance est appliquée comme suit :

  • Convertir la couleur au format de couleur TSL (valeurs entre 0 et 1)

  • Modifier le facteur de luminance comme suit :

  • Convertir la couleur TSL résultante à

[Exemple: pensez à un document avec un arrière-plan à l'aide de la couleur du thème accent2 , dont la valeur (au format hexadécimal RRGGBB) est C0504D.

La valeur de couleur TSL équivalente serait.

Appliquant la formule d'ombrer une nuance le pourcentage de 75 % pour la luminance, nous obtenons :

En prenant les conversion retour à la valeur de couleur TSL résultant de, nous obtenons 943634.

Cette valeur transformée est visible dans l'attribut de couleur de l'arrière-plan qui en résulte :

<w:top w:val="single" w:sz="4" w:space="24"   w:color="943634" w:themeColor="accent2"   w:themeShade="BF"/>

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_UcharHexNumber (§17.18.98).

themeTint (teinte de couleur de thème de bordure)

Spécifie la valeur de teinte appliquée à la couleur du thème fourni (le cas échéant) pour cette instance de bordure. Si l'attribut themeColor n'est pas présent, cet attribut ne doit pas être utilisé.

Si le themeTint est fournie, puis il est appliqué à la valeur de la couleur de thème (à partir de la partie de thème) pour déterminer la couleur finale appliquée à cette bordure.

La valeur themeTint est stockée sous la forme d'un hex de codage de la valeur de teinte (de 0 – 255) appliqué à la bordure en cours.

[Exemple: envisager une teinte de 60 % est appliquée à une bordure dans un document. Cette teinte est calculé comme suit :

La valeur de themeTint résultant dans le format de fichier serait 99. exemple de fin]

Étant donné une couleur est définie comme trois valeurs hexadécimales au format RRGGBB, la nuance est appliquée comme suit :

  • Convertir la couleur au format de couleur TSL (valeurs entre 0 et 1)

  • Modifier le facteur de luminance comme suit :

  • Convertir la couleur TSL résultante à

[Exemple: pensez à un document avec un arrière-plan à l'aide de la couleur du thème accent2 , dont la valeur (au format hexadécimal RRGGBB) est 4F81BD.

La valeur de couleur TSL équivalente serait.

Application de la formule de teinte avec un pourcentage de teinte de 60 % à la luminance, nous obtenons :

En prenant les conversion retour à la valeur de couleur TSL résultant de, nous obtenons 95B3D7.

Cette valeur transformée est visible dans l'attribut de couleur de l'arrière-plan qui en résulte :

<w:top w:val="single" w:sz="4" w:space="24"  w:color="95B3D7" w:themeColor="accent2"   w:themeTint="99"/>

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_UcharHexNumber (§17.18.98).

Val (Style bordure)

Spécifie le style de bordure utilisé sur cet objet.

Cette bordure peut être une bordure clipart (une image répétée le long des frontières - doit être utilisé uniquement pour les bordures de page) ou une bordure de ligne (un format de ligne répétée le long des bordures) - Voir la définition de type simple pour obtenir une description de chaque style de bordure.

[Exemple: envisager une bordure gauche, ce qui entraîne le schéma WordprocessingML suivant :

<w:left w:val="single" …/>

Val de cette bordure est unique, indiquant que le style de bordure est une ligne unique. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Border (§17.18.2).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_PageBorder) se trouve dans §A.1. fin de la Remarque]

[ISO/IEC 29500-1 1st Edition]

left (Left Border for HTML div)

Cet élément spécifie la bordure qui doit s'afficher à gauche des limites de l'objet div HTML.

Si cet élément est omis, puis cet objet de div HTML n'aura pas une bordure gauche.

[Exemple: pensez à un document HTML simple défini comme suit :

<html>
  <body>
    <div style=" border-left-style:solid; border-right-style:groove; border-right-width:1px; border-top-style:dashed; border-top-width:3px; border-bottom-style:outset; border-bottom-width:3px">
      <p>paragraph of text</p>
    </div>
  </body>
</html>

Ce code HTML doit donc normalement apparaître comme suit (image mise à l'échelle appropriée) :

Maintenant, lorsque ce document est enregistré au format WordprocessingML, les informations stockées sur les éléments div se trouve dans le composant WebPart paramètre comme suit :

<w:divs>
  <w:div w:id="1785730240">
     …    <w:divBdr>
      <w:top w:val="dashed" w:sz="18" w:space="7" w:color="auto" />
      <w:left w:val="single" w:sz="24" w:space="4" w:color="auto" />
      <w:bottom w:val="outset" w:sz="18" w:color="auto" />
      <w:right w:val="threeDEngrave" w:sz="6" w:color="auto" />
    </w:divBdr>
  </w:div>
</w:divs>

L'élément de gauche indique les informations de bordure sur la bordure gauche de la seule structure div HTML dans le document ; Dans ce cas, le point bordure inférieure de type unique. La bordure de 4 pixels initiale a été convertie en 3 points selon la logique suivante :

Fin de l’exemple]

Éléments parents

divBdr (§17.15.2.7)

Modèle de contenu de cet élément est défini par la définition de propriétés de bordure commune dans §17.3.4.

[ISO/IEC 29500-1 1st Edition]

left (Table Cell Leading Edge Border)

Cet élément est sémantiquement équivalent à démarrer (partie 1, §17.4.34), indiqué ci-dessus.

Pour les tables qui ont la propriété bidiVisual (partie 1, §17.4.1) appliquée, cette bordure est appliquée sur le bord droit de la cellule.

Éléments parents

tcBorders (partie 1, §17.4.67)

Modèle de contenu de cet élément est défini par la définition de propriétés de bordure commune dans la partie 1, §17.3.4.

[ISO/IEC 29500-1 1st Edition]

left (Table Leading Edge Border)

Cet élément est sémantiquement équivalent à démarrer (partie 1, §17.4.37), indiqué ci-dessus.

Pour les tables qui ont la propriété bidiVisual (partie 1, §17.4.1) appliquée, cette bordure est appliquée sur le bord droit du tableau.

Éléments parents

tblBorders (partie 1, §17.4.39) ; tblBorders (partie 1, §17.4.40)

Modèle de contenu de cet élément est défini par la définition de propriétés de bordure commune dans la partie 1, §17.3.4.

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: