## get_building_block(gallery, category, name) {#buildingblockgallery_str_str}

Finds a building block using the specified gallery, category and name.


```python
def get_building_block(self, gallery: aspose.words.buildingblocks.BuildingBlockGallery, category: str, name: str):
    ...
```

| Parameter | Type | Description |
| --- | --- | --- |
| gallery | [BuildingBlockGallery](../../buildingblockgallery/) | The gallery criteria. |
| category | str | The category criteria. Can be ``None``, in which case it will not be used for comparison. |
| name | str | The building block name criteria. |

### Remarks

This is a convenience method that iterates over all building blocks
in this collection and returns the first building block that matches
the specified gallery, category and name.

Microsoft Word organizes building blocks into galleries. The galleries
are predefined using the [BuildingBlockGallery](../../buildingblockgallery/) enum.
Within each gallery, building blocks can be organized into one or more categories.
The category name is a string. Each building block has a name. A building block
name is not guaranteed to be unique.




### Returns

The matching building block or ``None`` if a match was not found.


### See Also

* module [aspose.words.buildingblocks](../../)
* class [GlossaryDocument](../)