# convert_to_screen()

URL: https://chugunov.pro/api-wordpress/functions/convert_to_screen/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
convert_to_screen( string $hook_name ): WP_Screen
```

## Описание

Преобразует строку экрана в объект экрана.

## Параметры

- `$hook_name` `string` — обязательный. Имя хука (также известное как суффикс хука), используемое для определения экрана.

## Возвращаемое значение

`WP_Screen`

## Исходный код

Файл: `wp-admin/includes/template.php:2696`

```php
function convert_to_screen( $hook_name ) {
	if ( ! class_exists( 'WP_Screen' ) ) {
		_doing_it_wrong(
			'convert_to_screen(), add_meta_box()',
			sprintf(
				/* translators: 1: wp-admin/includes/template.php, 2: add_meta_box(), 3: add_meta_boxes */
				__( 'Likely direct inclusion of %1$s in order to use %2$s. This is very wrong. Hook the %2$s call into the %3$s action instead.' ),
				'<code>wp-admin/includes/template.php</code>',
				'<code>add_meta_box()</code>',
				'<code>add_meta_boxes</code>'
			),
			'3.3.0'
		);
		return (object) array(
			'id'   => '_invalid',
			'base' => '_are_belong_to_us',
		);
	}

	return WP_Screen::get( $hook_name );
}
```

## История изменений

- 3.0.0 — Introduced.

## Связанные

Использует: `WP_Screen::get`, [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`_doing_it_wrong`](https://chugunov.pro/api-wordpress/functions/_doing_it_wrong/).
Используется в: `_WP_List_Table_Compat::__construct`, [`get_column_headers`](https://chugunov.pro/api-wordpress/functions/get_column_headers/), [`get_hidden_columns`](https://chugunov.pro/api-wordpress/functions/get_hidden_columns/), [`meta_box_prefs`](https://chugunov.pro/api-wordpress/functions/meta_box_prefs/), [`get_hidden_meta_boxes`](https://chugunov.pro/api-wordpress/functions/get_hidden_meta_boxes/), [`add_contextual_help`](https://chugunov.pro/api-wordpress/functions/add_contextual_help/), `WP_List_Table::__construct`, [`_get_list_table`](https://chugunov.pro/api-wordpress/functions/_get_list_table/), `WP_List_Table`, [`add_meta_box`](https://chugunov.pro/api-wordpress/functions/add_meta_box/), [`do_meta_boxes`](https://chugunov.pro/api-wordpress/functions/do_meta_boxes/), [`remove_meta_box`](https://chugunov.pro/api-wordpress/functions/remove_meta_box/), [`do_accordion_sections`](https://chugunov.pro/api-wordpress/functions/do_accordion_sections/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/convert_to_screen/