# Javascript: Selection.getCapitals Method

> Gets values specifying wheather lowercase letters are displayed with capital letters. Lowercase letters are displayed either with capital letters of the same size or with capital letters which have a smaller size. The smaller size is either the size of the lowercase 'x' (petite caps) or the size of the lowercase 'x' + 10% (small caps).

- **Product:** DS Server
- **Section:** Reference
- **Kind:** Method
- **Introduced:** 30.0
- **Path:** DS Server > Reference > JavaScript API > Javascript: Selection.getCapitals Method
- **458 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/javascript/selection/getcapitals-method/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/javascript/selection/getcapitals-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/javascript/selection/getcapitals-method/llms-full.txt

---

### Description

Gets values specifying wheather lowercase letters are displayed with capital letters. Lowercase letters are displayed either with capital letters of the same size or with capital letters which have a smaller size. The smaller size is either the size of the lowercase 'x' (petite caps) or the size of the lowercase 'x' + 10% (small caps).

### Syntax

```javascript
<void> Selection.getCapitals([<RequestCapitalsCallback> callback], [<ErrorCallback> errorCallback])
```

### Parameters

| Parameter | Description |
|---|---|
| callback | Optional. Is called when the operation completed. |
| errorCallback | Optional. Is called when the operation failed with an error. |

### Examples

The following example demonstrates `Selection.getCapitals` in a practical document-editing workflow. It gets values specifying wheather lowercase letters are displayed with capital letters. Lowercase letters are displayed either with capital letters of the same size or with capital letters which have a smaller size. The smaller size is either the size of the lowercase 'x' (petite caps) or the size of the lowercase 'x' + 10% (small caps).

```javascript
function onTxError(error) {
    console.error("TX Text Control error:", error.msg);
    error.handled = true;
}

TXTextControl.selection.getCapitals(
    function(result) {
        if (!result) {
            console.warn("No capitals was returned.");
            return;
        }
        
        console.log("get capitals result:", result);
    },
    onTxError
);
```

---

## Nearby

- **Previous:** [Javascript: Selection.getBold Method](https://docs.textcontrol.com/ds-server/reference/javascript/selection/getbold-method/llms-full.txt)
- **Next:** [Javascript: Selection.getCharacterScaling Method](https://docs.textcontrol.com/ds-server/reference/javascript/selection/getcharacterscaling-method/llms-full.txt)