Attribute User Text

Toolbar

Menu

Shortcut

Popup
Properties
Standard

Edit

Object Properties

Window

Panels > Properties

F3

The Attribute User Text page lists the user text attached to the selected object.

Search

Type in the search box to only display the User Text that contains the typed text in its key or value.

Toolbar

New

Adds a User Text key to the object. Prefix a key with a "." (period) to add a hidden key.

Hidden keys will not appear in Object Properties > Attribute User Text.

Text Fields

Retrieves information from the current document or an object.

The Attribute User Text Functions dialog only provides the functions that make sense to store in the selected object.

  • Use "" as object ID to reference the object itself.

The full list of text field functions

Delete

Removes the selected User Text key from the object.

Use the SetUserText command to remove a hidden key.

Import

Reads User Text keys from a .csv or .txt file into the object.

Export

Saves User Text keys in the object to a .csv or .txt file.

Match

Copies the User Text keys in another object to the current object.

Key

The name of the UserText.

Value

The value of the UserText.

Type

The type of the UserText.

It can be Plain text, Block Attribute Text, or Textfield.

Example

Key

Value

(Type)

Part name

X-Joint

 

Part number

XJT-20-584

 

Supplier

Krypton Metals, Inc.

 

Material

Titanium

FileName

Parts

See: Naming conventions in Rhino

Sort the list

  • Click the Key, Value, or Type column header.

Indicators

The indicators in the list provide some information of the user text items.

 

Key

Value

(Type)

Number

5

 

Area

24.2

Material Brass

= A key shared by all the selected objects.

= A key shared by some of the selected objects.

= A key driven by a text field function.

  • Double-click the icon to edit the text field.

= A Block Attribute Text.

  • A Block Attribute Key ("Material" in the table above) can only be edited via the BlockEdit command.

Right-click context menu

Select objects by key

Selects all the other objects that have the selected key.

Select objects by value

Selects all the other objects that have the selected value.

Select objects by key and value

Selects all the other objects that have the selected [key: value].

Objects that only have the key or value will not be selected.

Copy key and value

Copies the selected key and value to the Clipboard.

Paste key and value

Pastes the key and value from the Clipboard.

Paste key and value to all layouts

Pastes the key and value stored in the Clipboard to every layout.

  • User Text can be copied and pasted between object, layout, and document properties.
  • Attribute User Text is pasted to Document User Text or Layout User Text in the format of <Key>:<Object Name>|<Value>. If the object does not have a name, <Object Name> is replaced by the object's GUID.
  • Paste key and value to all layouts does not overwrite the values of existing keys.

See also

GetUserText

Retrieve text information attached to an object using the SetUserText command.

SetUserText

Attach text information to an object.

SelKey

Select objects by their user attribute key.

SelKeyValue

Select objects by their user attribute key and value.

SelValue

Select objects by their user attribute value.