この関数は、描画メソッドを使用してテキストを表示するためのフォントを設定し、その操作の結果を返します。サイズが-120(12 pt)のArialフォントがデフォルトで使用されます。
bool TextSetFont( |
パラメーター
名
[in]システム内のフォント名、またはフォントを含むリソースの名前またはディスク上のフォントファイルへのパス。
サイズ
[入力]正と負の値を使用して設定できるフォントサイズ。正の値の場合、表示されるテキストのサイズは、オペレーティングシステムのフォントサイズ設定に依存しません。負の値の場合、値は10分の1ポイントで設定され、テキストサイズはオペレーティングシステムの設定(「標準スケール」または「大スケール」)に依存します。モード間の違いの詳細については、以下の注を参照してください。
flags = 0
[in] フォントスタイルを記述するフラグの組み合わせ。
方向= 0
[in] X軸に対するテキストの水平方向の傾き、測定単位は0.1度です。これは、orientation = 450 が45度に等しい傾斜を表すことを意味します。
戻り値
現在のフォントが正常にインストールされている場合はtrueを返し、そうでない場合はfalseを返します。考えられるコードエラー:
- ERR_INVALID_PARAMETER(4003)- 名前はNULLまたは “”(空の文字列)を表します。
- ERR_INTERNAL_ERROR(4001)-オペレーティングシステムエラー(たとえば、存在しないフォントを作成しようとした)。
注意
フォント名に「::」が使用されている場合、フォントはEX4リソースからダウンロードされます。場合は名前のフォント名を拡張子で指定され、フォントはパスは「\」または「/」から始まる場合、ファイルはMQL4ディレクトリを基準にして検索され、ファイルからダウンロードされます。それ以外の場合は、TextSetFont()関数を呼び出したEX4ファイルのパスに対して相対的に検索されます。
フォントサイズは、正または負の値を使用して設定されます。この事実は、オペレーティングシステムの設定(サイズスケール)からのテキストサイズの依存関係を定義します。
- サイズが正の数で指定されている場合、このサイズは、論理フォントを物理フォントに変更するときにデバイスの物理測定単位(ピクセル)に変換されます。このサイズは、使用可能なフォントから選択した記号グリフの高さに対応します。TextOut()関数によって表示されるテキストとOBJ_LABEL( “ラベル”)グラフィカルオブジェクトによって表示されるテキストをチャートで一緒に使用する場合、このケースはお勧めしません。
- サイズが負の数で指定されている場合、この数は論理ポイントの10分の1に設定され(-350は35の論理ポイントに等しい)、10で除算されます。得られた値は、次に物理測定単位に変換されます。デバイス(ピクセル)。使用可能なフォントから選択されたシンボルの高さの絶対値に対応します。オブジェクトプロパティで指定されたフォントサイズに-10を掛けて、画面上のテキストのサイズをOBJ_LABELオブジェクト内のテキストのサイズと同様にします。
フラグは、スタイルフラグとフォント幅を指定するフラグの1つとの組み合わせとして使用できます。フラグ名を以下に示します。
旗 | 説明 |
FONT_ITALIC | イタリック |
FONT_UNDERLINE | 下線 |
FONT_STRIKEOUT | 三振 |
フォント幅を指定するためのフラグ
旗 |
FW_DONTCARE |
FW_THIN |
FW_EXTRALIGHT |
FW_ULTRALIGHT |
FW_LIGHT |
FW_NORMAL |
FW_REGULAR |
FW_MEDIUM |
FW_SEMIBOLD |
FW_DEMIBOLD |
FW_BOLD |
FW_EXTRABOLD |
FW_ULTRABOLD |
FW_HEAVY |
FW_BLACK |