Élément SplitButton (ruban serveur)
S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
Définit un contrôle qui combine un bouton et un menu déroulant.
<SplitButton
Alt="Text"
CacheMenuVersions="TRUE | FALSE"
Command="Text"
CommandMenuOpen="Text"
CommandMenuClose="Text"
CommandType="General | OptionSelection | IgnoredByMenu"
Id="Text"
Image32by32="Url"
Image32by32Class="CSS Class Selector"
Image32by32Left="Negative Integer"
Image32by32Top="Negative Integer"
Image16by16="Url"
Image16by16Class="CSS Class Selector"
Image16by16Left="Negative Integer"
Image16by16Top="Negative Integer"
LabelText="Text"
MenuAlt="Text"
MenuCommand="Text"
PopulateDynamically=" TRUE | FALSE "
PopulateQueryCommand="Text"
PopulateOnlyOnce=" TRUE | FALSE "
Sequence="Integer"
TemplateAlias="Text"
ToolTipImage32by32="Url"
ToolTipImage32by32Class="CSS Class Selector"
ToolTipImage32by32Left="Negative Integer"
ToolTipImage32by32Top="Negative Integer"
ToolTipTitle="Text"
ToolTipDescription="Text"
ToolTipHelpKeyWord="Text"
ToolTipSelectedItemTitle="Text"
ToolTipShortcutKey="Text"
/>
Éléments et attributs
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
Attribut | Description |
---|---|
Alt |
Facultatif. Texte de remplacement utilisé pour le contrôle. |
CacheMenuVersions |
Facultatif. TRUE pour stocker les versions d’un menu dynamique précédemment construites. La valeur par défaut est FALSE. |
Commande |
Facultatif. Nom de la commande à exécuter lorsque le contrôle est sélectionné. Si le contrôle se trouve dans un élément CommandUIDefinition, la valeur de l’attribut Command du contrôle doit être identique à la valeur de l’attribut Command d’un élément CommandUIHandler correspondant. |
CommandMenuOpen |
Facultatif. Nom de la commande à exécuter lorsque le menu s’ouvre. |
CommandMenuClose |
Facultatif. Nom de la commande à exécuter lorsque le menu se ferme. |
CommandType |
Facultatif. Valeur d’énumération qui spécifie le type de commande. Général. Type de commande non spécifique. OptionSelection. Commande générée lorsqu’un utilisateur sélectionne une option dans un groupe d’options. IgnoredByMenu. Commande utilisée pour les contrôles qui ne doivent pas fermer le menu lorsqu’ils sont sélectionnés. |
Id |
Obligatoire. Chaîne qui identifie le contrôle. |
Image32by32 |
Facultatif. URL relative du serveur vers un fichier qui contient une image de 32 pixels par 32 pixels à utiliser comme icône, telle que « /_layouts/1033/images/formatmap32x32.png ». |
Image32by32Class |
Facultatif. Nom d’un sélecteur de classe CSS à appliquer à l’image. |
Image32by32Left |
Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut Image32by32 pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image32by32Left permet de définir l’attribut CSS left pour le style intraligne d’une balise HTML img. Par exemple, la définition de l’attribut Image32by32Left sur « -160 » et de l’attribut Image32by32Top sur « -448 » entraîne un style inline similaire à celui du balisage HTML suivant : HTML<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" /> |
Image32by32Top |
Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut Image32by32 pointe vers un fichier image qui contient les images de nombreuses icônes. La valeur de l’attribut Image32by32Top permet de définir l’attribut CSS top pour le style intraligne d’une balise HTML img. |
Image16by16 |
Facultatif. URL relative du serveur vers un fichier qui contient une image de 16 pixels par 16 pixels à utiliser comme icône, telle que « /_layouts/1033/images/formatmap16x16.png ». |
Image16by16Class |
Facultatif. Nom d’un sélecteur de classe CSS à appliquer à l’image. |
Image16by16Left |
Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut Image16by16 pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image16by16Left permet de définir l’attribut left CSS pour le style intraligne d’une balise img HTML. |
Image16by16Top |
Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut Image16by16 pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image16by16Top permet de définir l’attribut CSS top pour le style intraligne d’une balise HTML img. |
LabelText |
Facultatif. Texte de l’étiquette du contrôle. |
MenuAlt |
Facultatif. Texte de remplacement pour représenter le menu. |
MenuCommand |
Facultatif. Nom de la commande à exécuter lorsque le menu est sélectionné. |
Remplir De manière dynamique |
Facultatif. TRUE pour créer le menu dynamiquement. La valeur par défaut est FALSE. |
PopulateQueryCommand |
Facultatif. Nom de la commande à exécuter lors de la création d’un menu dynamique. |
PopulateOnlyOnce |
Facultatif. TRUE pour remplir un menu dynamique uniquement la première fois que l’utilisateur y accède. |
Sequence |
Facultatif. Entier qui spécifie l’ordre d’emplacement dans les nœuds XML frères. |
TemplateAlias |
Facultatif. Chaîne qui correspond à la valeur de l’attribut TemplateAlias pour un élément ControlRef, un élément OverflowArea ou un élément OverflowSection dans un élément GroupTemplate. L’attribut TemplateAlias permet de dimensionner et de positionner les contrôles dans un groupe lorsqu’un modèle est appliqué au groupe. |
Info-bulleImage32by32 |
Facultatif. URL relative du serveur vers un fichier qui contient une image de 32 pixels de 32 pixels à utiliser dans l’info-bulle, telle que « /_layouts/1033/images/formatmap32x32.png ». |
Info-bulleImage32by32Class |
Facultatif. Nom d’un sélecteur CSS à appliquer à l’image de l’info-bulle. |
Info-bulleImage32by32Left |
Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut ToolTipImage32by32 pointe vers un fichier image qui contient les images de nombreuses icônes. La valeur de l’attribut ToolTipImage32by32Left permet de définir l’attribut CSS left pour le style intraligne d’une balise HTML img lorsque la page est créée. |
Info-bulleImage32by32Top |
Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut ToolTipImage32by32 pointe vers un fichier image qui contient les images de nombreuses icônes. La valeur de l’attribut ToolTipImage32by32Top permet de définir l’attribut CSS top pour le style intraligne d’une balise HTML img lorsque la page est créée. |
ToolTipTitle |
Facultatif. Texte qui apparaît comme titre de l’info-bulle. |
Info-bulleDescription |
Facultatif. Texte qui apparaît dans le corps de l’info-bulle. |
ToolTipHelpKeyWord |
Facultatif. Mot clé utilisé par l’aide contextuelle. |
ToolTipSelectedItemTitle |
Facultatif. Titre de l’info-bulle qui apparaît pour l’élément sélectionné. |
ToolTipShortcutKey |
Facultatif. Texte à afficher pour la touche de raccourci dans l’info-bulle. Par exemple, si la touche de raccourci du contrôle est Alt+J, la valeur de cet attribut est « Alt+J ». L’info-bulle affiche le texte de la touche de raccourci entre parenthèses après le titre de l’info-bulle : « (Alt+J) ». |
Éléments enfants
Éléments parents
Occurrences
- Minimum : 0
- Maximum : pas de limite