VP Object to font
VP Object to font ( fontObj : Object ) : Text
引数 | 型 | 説明 | ||
---|---|---|---|---|
fontObj | Object | -> | フォントオブジェクト | |
戻り値 | Text | <- | フォントのショートハンド文字列 |
説明
VP Object to font
コマンドは、fontObj 引数で指定したフォントオブジェクトからフォントのショートハンド文字列を返します。
fontObj には、フォントプロパティを格納するオブジェクトを渡します。 以下のプロパティがサポートされています:
プロパティ | 型 | 説明 | とりうる値 | 必須 |
---|---|---|---|---|
family | text | フォントを指定します。 | 標準の、あるいは一般的なフォントファミリー。 例: "Arial", "Helvetica", "serif", "arial,sans-serif" | ◯ |
size | text | フォントのサイズを定義します。"font-size/line-height" の形で line-height をfont-size に追加することもできます: 例: "15pt/20pt" | 以下のいずれかの単位を伴う数値: vk font size large vk font size larger vk font size x large vk font size xx large vk font size small vk font size smaller vk font size x small vk font size xx small | ◯ |
style | text | フォントのスタイル。 | vk font style italic vk font style oblique | × |
variant | text | スモールキャピタルのフォントを定義します。 | vk font variant small caps | × |
weight | text | フォントの太さを定義します。 | vk font weight 100 vk font weight 200 vk font weight 300 vk font weight 400 vk font weight 500 vk font weight 600 vk font weight 700 vk font weight 800 vk font weight 900 vk font weight bold vk font weight bolder vk font weight lighter | × |
このオブジェクトは VP Font to object コマンドで作成することができます。
返されるショートハンド文字列は、たとえば VP SET CELL STYLE を使って、セルの "font" プロパティに割り当てることができます。
例題
$cellStyle:=VP Get cell style($range)
$font:=VP Font to object($cellStyle.font)
$font.style:=vk font style oblique
$font.variant:=vk font variant small caps
$font.weight:=vk font weight bolder
$cellStyle.font:=VP Object to font($font)
//$cellStyle.font には "bolder oblique small-caps 16pt arial" が格納されます