WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

LabeledGraphicsBox
✖
LabeledGraphicsBox

Unsupported in CloudNew in 14.2

✖

is a low-level construct that represents a graphics box with a label attached to it.

✖
LabeledGraphicsBox[box,lbl,pos]

places lbl at a position specified by pos.

✖
LabeledGraphicsBox[box,{lbl1,lbl2,…},{pos1,pos2,…}]

places the lbli at positions posi.

Details and Options

  • LabeledGraphicsBox is one possible low-level representation of Labeled. Except for low-level notebook expression manipulation, LabeledGraphicsBox should not need to be used directly.
  • box must be a GraphicsBox, Graphics3DBox or a LabeledGraphicsBox.
  • Selecting a LabeledGraphicsBox will result in a graphics-style selection with resize handles that can be used to resize the whole construct.
  • Resizing a LabeledGraphicsBox will automatically resize box to use the full available space, minus the space required to draw labels.
  • Possible forms for the posi are:
  • sidecentered on the specified side
    {side,align}on the specified side with the specified alignment
  • Possible forms for side include Bottom, Left, Top, Right.
  • Possible forms for align include Center, Left, Right, Bottom, Top.
  • The effective default for pos is normally Bottom.
  • The following options can be given:
  • BaselinePosition Automaticthe position of the base line for the box
    BaseStyle "LabeledGraphics"base style specifications for the whole box
    DefaultLabelStyle"LabeledGraphicsLabel"base style specifications for the whole box
    ImageMargins 0margins to add outside the display area
    ImageSize Automaticthe overall image size of the box
    LabelStyle Automaticstyle specification for the lbli
    Spacings Automatichorizontal and vertical label spacings
  • ImageSizeAutomatic will cause LabeledGraphicsBox to display box at its specified size and add additional space as needed to fit the lbli. Other values will set the absolute size of the entire construct and resize box automatically to fit in the available space.
  • LabeledGraphicsBox is used in the typesetting of some Labeled constructs.

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

A 2D labeled graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-gj9fz
Out[1]=1

A 3D labeled graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-gak8nh
Out[1]=1

Label positioned at the left of a graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-ccxcgh
Out[1]=1

A label on the left and a label at the top:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-yh9i73
Out[1]=1

Scope  (15)Survey of the scope of standard use cases

Label Content  (6)

Label a graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-rkslvy
Out[1]=1

Label a 3D graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-8a0yhg
Out[1]=1

Use a checkbox as a label:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-f4x8u7
Out[1]=1

Use a checkbox as a label for a 3D graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-edilrb
Out[1]=1

Use graphics as labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-mhgxc6
In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-l9idi2
Out[2]=2

Use 3D graphics as labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-vl0et4
In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-84wa2b
Out[2]=2

Label Placement  (4)

Control the placement of labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-blfcxu
Out[1]=1

Place the label at the bottom, aligned to the left:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-d6jc9y
Out[1]=1

Put the label on the right, aligned to the top:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-dix4q
Out[1]=1

A label on the right aligned to the top compared to a label at the top aligned to the right:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-kxxoep
Out[1]=1

Box Usage  (5)

Create a nested LabeledGraphicsBox:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-8x6rb5
Out[1]=1

Use a LabeledGraphicsBox as a label:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-7v600b
Out[1]=1

Use multiple levels of nested LabeledGraphicsBox instances using nested LabeledGraphicsBox instances as labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-cnt1ei
Out[1]=1

Use LabeledGraphicsBox as an Inset:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-l7vmps
Out[1]=1

Use LabeledGraphicsBox as an Inset in a 3D graphic:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-omdnek
Out[1]=1

Options  (15)Common values & functionality for each option

Background  (1)

Change the overall background color:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-qm3n2
Out[1]=1

BaselinePosition  (1)

Align with surrounding text:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-bny4af
Out[1]=1

BaseStyle  (1)

Set the starting style:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-qlrhns
Out[1]=1

ContentSelectable  (1)

By default, editing of labels and expressions is allowed:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-lnluk7
Out[1]=1

Disallow editing:

In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-dc1otc
Out[2]=2

ImageMargins  (1)

Add margins around the labeled expression:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-m05k4y
Out[1]=1

Specify different margins for each side:

In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-1f21p5
Out[2]=2

ImageSize  (1)

The image size by default is the size of the inner graphic plus the space for the labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-4v1se8
Out[1]=1

Giving explicit values to ImageSize resizes the inner graphic to fill the available space:

In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-c948e0
Out[2]=2

ImageSize resizes the inner graphic even if it has an explicitly larger size:

In[3]:=3
✖
https://wolfram.com/xid/0bnis7gsrrc9y-x91fa8
Out[3]=3

LabelStyle  (1)

Style the labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-q6c12r
Out[1]=1

RotateLabel  (4)

Specify that the label should be rotated:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-l6qjmg
Out[1]=1

Rotate the label to a particular angle in degrees:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-m548lm
Out[1]=1

Rotate the label to a particular angle using radians:

In[2]:=2
✖
https://wolfram.com/xid/0bnis7gsrrc9y-sryzwv
Out[2]=2

Specify custom rotations for the different labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-cegxq7
Out[1]=1

Rotate nested labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-46ctax
Out[1]=1

Spacings  (4)

Add horizontal spacing between the expression and the label:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-s80eep
Out[1]=1

Specify vertical spacing:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-ij9942
Out[1]=1

Use both vertical and horizontal spacing:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-jw2rf
Out[1]=1

Dynamically update the rotation of the labels:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-eejb6c
Out[1]=1
Out[1]=1

Applications  (2)Sample problems that can be solved with this function

Label images with checkboxes, potentially for later processing:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-rzegsn
Out[1]=1

Create an active label:

In[1]:=1
✖
https://wolfram.com/xid/0bnis7gsrrc9y-iro97l
Out[1]=1
Wolfram Research (2025), LabeledGraphicsBox, Wolfram Language function, https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.
✖
Wolfram Research (2025), LabeledGraphicsBox, Wolfram Language function, https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.

Text

Wolfram Research (2025), LabeledGraphicsBox, Wolfram Language function, https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.

✖
Wolfram Research (2025), LabeledGraphicsBox, Wolfram Language function, https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.

CMS

Wolfram Language. 2025. "LabeledGraphicsBox." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.

✖
Wolfram Language. 2025. "LabeledGraphicsBox." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html.

APA

Wolfram Language. (2025). LabeledGraphicsBox. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html

✖
Wolfram Language. (2025). LabeledGraphicsBox. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html

BibTeX

@misc{reference.wolfram_2025_labeledgraphicsbox, author="Wolfram Research", title="{LabeledGraphicsBox}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html}", note=[Accessed: 18-March-2025 ]}

✖
@misc{reference.wolfram_2025_labeledgraphicsbox, author="Wolfram Research", title="{LabeledGraphicsBox}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html}", note=[Accessed: 18-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_labeledgraphicsbox, organization={Wolfram Research}, title={LabeledGraphicsBox}, year={2025}, url={https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html}, note=[Accessed: 18-March-2025 ]}

✖
@online{reference.wolfram_2025_labeledgraphicsbox, organization={Wolfram Research}, title={LabeledGraphicsBox}, year={2025}, url={https://reference.wolfram.com/language/ref/LabeledGraphicsBox.html}, note=[Accessed: 18-March-2025 ]}