※ ここでは、まいと〜く COLOR FAX V6 クライアント を、FAX クライアント と表記しています。
| ● アプリケーション名 | : MYFAXWC |
| ● トピック名 | : SENDFAX、CONTROL |
| ・ DDE 機能の利用開始 | : DDEInitiate |
| ・ コマンドの実行 | : DDEExecute |
| ・ アイテムによる情報の取得 | : DDERequest |
| ・ DDE 機能の利用終了 | : DDETerminate |
コマンド
FAX クライアント のコマンドには、次の 2 種類があります。
* FAX クライアント の制御
| AppExit (CONTROL) | ClearSendFax (SENDFAX) |
| SaveAs (SENDFAX) | SendAbort (SENDFAX) |
| SendFaxExecute (SENDFAX) |
| トピック名: | CONTROL |
| 機 能: | FAX クライアント を終了させます。 |
| 書 式: | AppExit |
| 引 数: | なし |
| トピック名: | SENDFAX |
| 機 能: | FAX クライアント に設定されている送信先情報を、すべて消去します。 ただし、アプリケーションからの印刷、または[SendFaxExecute]コマンドの実行によって、送信ログにデータが登録された場合には、その時点で設定されているすべての送信先情報が消去されますので、改めてこのコマンドを実行する必要はありません。 また、すでに送信ログに登録されたデータを、このコマンドで削除することはできません。 |
| 書 式: | ClearSendFax |
| 引 数: | なし |
| トピック名: | SENDFAX |
| 機 能: | 次に印刷されるデータを送信ログに登録せずに、指定したイメージ ファイルとして保存する設定をします。 複数のアプリケーションからの印刷データを、まとめて送信したい場合などに便利です。 このコマンドを指定してから印刷した場合は、送信先の設定と送付状の設定は無効になります。 また、[SendFaxExecute]コマンドで送信を開始した場合は、このコマンドでの設定は無効になります。 通常は、印刷したデータをイメージ ファイルとして保存しなくても、そのまま送信することができますので、このコマンドを使用する必要はありません。 |
| 書 式: | SaveAs( FileName) |
| 引 数: | FileName |
| 保存するイメージ データのファイル名。 イメージ ファイル名には、ドライブやフォルダ名も指定できます。 ドライブやフォルダ名の指定を省略すると、FAX クライアント がインストールされているフォルダ下の、[FAXSAVE]フォルダのファイルとして処理されます。 拡張子は必ず「.MFS」にしてください。 すでに同名のファイルが存在した場合は、強制的に上書きされます。 また、空文字列(ヌル)を指定すると、[SaveAs]コマンド自体の指定を取り消し、次回アプリケーションから印刷した際、送信ログに登録されるようになります。 |
| トピック名: | SENDFAX |
| 機 能: |
送信中や送信待機中のログを中断させます。 送信中であった場合、直ちに中断し終了するまで待ちます。 |
| 書 式: | SendAbort ( ReceiptNumber ) |
| 引 数: | ReceiptNumber |
| 送信を中断するログの受付番号。 「0」を指定すると、最後におこなった送信を中断します。 |
| トピック名: | SENDFAX |
| 機 能: |
設定されている送信先情報に基づいて、送信ログにデータを登録します。 [SendToV4]コマンドによって送信先が設定されていない場合は、このコマンドを実行しても送信ログにデータは登録されません。 このコマンドは、アプリケーションから印刷するデータがなく、送付状や添付イメージ ファイルだけを送信する場合に利用します。 このコマンドを実行しなくても、アプリケーションから印刷を実行すれば、送信ログにデータは登録されます。 |
| 書 式: | SendFaxExecute |
| 引 数: | なし |
| トピック名: | SENDFAX | ||||||||||||||||||||||||||
| 機 能: | FAXまたはインターネットFAXでおこなう送信先の情報を設定します。同報送信を行う場合には、このコマンドを相手先の数だけ繰り返し実行します。 DDE機能で送信先を設定する場合、最低限このコマンドだけは実行する必要があります。 | ||||||||||||||||||||||||||
| 書 式: | SendToV4( CountryCode, FaxAreaNumber, FaxNumber, MailAddress, 予約, Name, Title,Company, Section, Position, VoiceAreaNumber, VoiceNumber, strFurigana ) | ||||||||||||||||||||||||||
| 引 数: | |||||||||||||||||||||||||||
|
※【 SendToV4 】で設定した内容はプリンタドライバに対して印刷をかけるか【 ClearSendFax
】を実行するまで有効です。
印刷時にエラーが起きた場合、送信先情報はそのまま有効となってしまいますので、ご注意ください。
| トピック名: | SENDFAX | ||||||||||||||||||||||
| 機 能: | FAX の送信先を設定します。 同報送信の場合には、このコマンドを送信先の数だけ繰り返し実行します。 このコマンドは、まいと〜く FAX V.3 の DDE 機能との互換性を保つために用意されています。できる限り、[SendToV4]コマンドを使用してください。 | ||||||||||||||||||||||
| 書 式: | SendToV3( CountryCode, FaxAreaNumber, FaxNumber, Name, Title, Company, Section, Position, VoiceAreaNumber, VoiceNumber, Furigana ) | ||||||||||||||||||||||
| 引 数: | |||||||||||||||||||||||
|
※【 SendToV3 】で設定した内容はプリンタドライバに対して印刷をかけるか【 ClearSendFax
】を実行するまで有効です。
印刷時にエラーが起きた場合、送信先情報はそのまま有効となってしまいますので、ご注意ください。
| トピック名: | SENDFAX | ||||||||||||||||
| 機 能: |
FAX の送信先を設定します。 同報送信の場合には、このコマンドを送信先の数だけ繰り返し実行します。 このコマンドは、まいと〜く FAX for Windows V.2 の DDE 機能との互換性を保つために用意されています。できる限り、[SendToV4]コマンドを使用してください。 | ||||||||||||||||
| 書 式: | SendTo( FaxNumber, Name, Title, Company, Section, Position, VoiceNumber, Furigana ) | ||||||||||||||||
| 引 数: | |||||||||||||||||
|
※【 SendTo 】で設定した内容はプリンタドライバに対して印刷をかけるか【 ClearSendFax
】を実行するまで有効です。
印刷時にエラーが起きた場合、送信先情報はそのまま有効となってしまいますので、ご注意ください。
| トピック名: | SENDFAX | ||||||||||||||||||||
| 機 能: |
自局情報を設定します。ここで設定した内容は、添付される送付状に反映されます。 このコマンドを実行せずに FAX 送信を開始した場合は、FAX クライアント 本体で常用設定された自局情報が有効になります。 また、このコマンドが複数回実行された場合には、最後に設定された内容が有効です。 | ||||||||||||||||||||
| 書 式: | SendFrom( Voice, Name, Company, Section, Address1, Address2, Fax, RemoteID, Handy, MailAddress ) | ||||||||||||||||||||
| 引 数: | |||||||||||||||||||||
|
| トピック名: | SENDFAX | ||||||
| 機 能: |
送信する日付を設定します。 このコマンドが複数回実行された場合には、最後に設定された内容が有効になります。 なお、送信時刻は[SendTime]コマンドで設定しますので、そちらを参照してください。 | ||||||
| 書 式: | SendDate( Date ) | ||||||
| 引 数: | Date 送信する日付。「YY-MM-DD」の書式で設定します。 | ||||||
|
| トピック名: | SENDFAX | ||||
| 機 能: |
送信する時刻を設定します。 このコマンドが複数回実行された場合には、最後に設定された内容が有効になります。 日付は[SendDate]コマンドで設定します。 | ||||
| 解 説: |
[SendDate]と[SendTime]コマンドの組み合わせで、実際の送信日時は以下のように決定します。
また、送信ログにデータが登録された時点で、すでに指定された日時が過ぎていた場合は、即時に送信を開始します。 | ||||
| 書 式: | SendTime( Time ) | ||||
| 引 数: | Time 送信する時刻。「hh:mm」の書式で設定します。 | ||||
|
| トピック名: | SENDFAX |
| 機 能: |
FAX 送信時に添付する送付状を設定します。 送付状ファイル名を空文字列(ヌル)にすると、送付状を添付しません。 このコマンドを実行せずに FAX 送信を開始した場合、送付状の有無や種類は、FAX クライアント 本体での設定が有効になります。 また、このコマンドが複数回実行された場合には、最後に設定された内容が有効です。 |
| 書 式: | CoverPage( CoverPage ) |
| 引 数: | CoverPage |
| 添付する送付状ファイル名。送付状ファイル名に、ドライブやフォルダは指定できません。 FAX クライアント がインストールされているフォルダ下の、[FAXCOVER]フォルダのファイルとして処理されます。 |
| トピック名: | SENDFAX |
| 機 能: |
FAX 送信時に添付する送付状の、メモ欄の内容を設定します。 設定した文字列が、メモ欄に埋め込まれます。 このコマンドが複数回実行された場合には、最後に設定された内容が有効になります。ただし、送付状が添付されない場合、および添付する送付状にメモ欄が存在しない場合は、設定は無効になります。 |
| 書 式: | CoverPageMemo( CoverPageMemo ) |
| 引 数: | CoverPageMemo |
| 512 バイトまでのメモ内容。メモ欄に入りきらない部分は削除されます。 また、メモ欄が複数ある場合、1 つ目のメモ欄にのみ設定が可能です。 ※文字数には、改行コード(2 バイト分)も含まれます。 |
| トピック名: | SENDFAX |
| 機 能: |
FAX 送信時に添付する、イメージ ファイルを設定します。 複数のファイルを添付したい場合は、このコマンドをその数だけ繰り返し実行します。 ただし、FAX 送信がアプリケーションからの印刷によって開始された場合、設定は無効になります。 |
| 書 式: | FaxFile( FaxFile ) |
| 引 数: | FaxFile |
| 添付するイメージ ファイル名。
ファイル名に、ドライブやフォルダは指定できません。 FAX クライアント がインストールされているフォルダ下の、[FAXSAVE]フォルダのファイルとして処理されます。 |
| トピック名: | SENDFAX | ||||
| 機 能: |
アプリケーションから印刷するときの解像度を設定します。 このコマンドを実行せずに印刷した場合は、FAX クライアント のプリンタ ドライバ「Mytalk FAX Client」で設定されている解像度で印刷されます。 また、このコマンドが複数回実行された場合は、最後に設定された内容が有効になります。 ただし、プリンタ ドライバで解像度が「スーパー ファイン(超高解像度)」に設定されている場合は、ここでの設定が無効になり、スーパー ファインで印刷されます。 なお、Mytalk FAX Client(Color) のプリンタドライバで印刷する場合このコマンドの設定は無効になります。 Mytalk FAX Client (Color) の画質の設定はあらかじめコントロールパネルの Mytalk FAX Client (Color) のプリンタドライバで設定しておいてください。 | ||||
| 書 式: | Resolution( Resolution ) | ||||
| 引 数: | Resolution
印刷する解像度。以下の文字列で指定します。 | ||||
|
| トピック名: | SENDFAX | ||||
| 機 能: | FAXを送信する際に、FAXの優先度を2段階で指定します。 このコマンドを実行せずにFAX送信を開始した場合、FAXの優先度は、普通を示す「0」となります。 このコマンドが複数回実行された場合は、最後に設定された内容が有効となります。 |
||||
| 書 式: | Priority( Priority ) | ||||
| 引 数: | Priority FAXの優先度を2段階で指定します。 |
||||
|
アイテム
FAX クライアント には、次の 2種類のアイテムがあります。
* FAX クライアント の状態や各種情報の取得
| Status (SENDFAX) | Result (SENDFAX) |
| ReceiveFax (CONTROL) |
| トピック名: | CONTROL |
| 機 能: | FAX クライアント がインストールされているフォルダを取得します。 |
| 戻 り 値: | FAX クライアント がインストールさているフォルダを、フルパスで返します。 |
| トピック名: | CONTROL |
| 機 能: | 送付状が保存されているフォルダを取得します。 |
| 戻 り 値: | 送付状が保存されているフォルダを、フルパスで返します。 |
| トピック名 | : | CONTROL |
| 機 能 | : | グループログフォルダ内のイメージファイルが保存されているフォルダを取得します。 |
| 戻 り 値 | : | グループログフォルダ内のイメージファイルが保存されているフォルダを、フルパスで返します。 |
| トピック名 | : | CONTROL |
| 機 能 | : | グループログフォルダ内の保存ファイルが保存されているフォルダを取得します。 |
| 戻 り 値 | : | グループログフォルダ内の保存ファイルが保存されているフォルダを、フルパスで返します。 |
| トピック名: | CONTROL |
| 機 能: | 送受信したイメージ ファイルを保存しているフォルダを取得します。 |
| 戻 り 値: | 送受信したイメージ ファイルが保存されているフォルダを、フルパスで返します。 |
| トピック名: | SENDFAX |
| 機 能: | 最後に設定された送信先の受付番号を取得します。 |
| 戻 り 値: | 最後に設定された送信先の受付番号を返します。 |
| トピック名 | : | CONTROL | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 機 能 | : | 最後に受信した FAX の受信結果を取得します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 戻 り 値 | : | 以下の書式の文字列を返します。 [状態],[詳細コード],[総ページ数],[受信日付],[受信時刻], [通信時間],[通信速度],[FAX ID],[イメージ ファイル名] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| トピック名 | : | SENDFAX | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 機 能 | : | 指定した受付番号に対応したデータの、送信結果を取得します。 なお、受付番号を省略すると、最後に送信終了したデータの送信結果を取得します。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 戻 り 値 | : | 以下の書式の文字列を返します。 [受付番号],[状態],[詳細コード],[総ページ数],[成功ページ数],[送信日付], [送信時刻],[通信時間],[予約],[通信速度],[FAX ID],[イメージ ファイル名] |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| トピック名: | CONTROL |
| 機 能: | 添付用のイメージ ファイルが保存されているフォルダを取得します。 |
| 戻 り 値: | 添付用のイメージ ファイルが保存されているフォルダを、フルパスで返します。 |
| トピック名: | SENDFAX | ||||||||||||||
| 機 能: | 指定した受付番号に対応したデータの、現在の送信状態を取得します。 送信終了したデータのより詳細な情報を取得するには、[Result[受付番号]]アイテムを利用してください。 なお、受付番号を省略すると、最後に状態の変化したデータの送信状態が取得されます。 | ||||||||||||||
| 戻 り 値: |
以下の書式の文字列を返します。 [受付番号],[状態] | ||||||||||||||
|
| トピック名: | SENDFAX |
| 機 能: | DDE 機能を用いて送信ログに登録した、送信データのいずれかの状態が変化したときに通知されます。 |
| 戻 り 値: | 送信状態を表す文字列を返します。 書式は、[SENDFAX]トピックの[Status[受付番号]]アイテムの戻り値と同一ですので、そちらを参照してください。 |
| トピック名: | SENDFAX |
| 機 能: | DDE 機能を用いて、送信ログに登録したデータのいずれかが、送信終了したときに通知されます。 |
| 戻 り 値: | 送信結果を表す文字列を返します。 書式は、[SENDFAX]トピックの[Result[受付番号]]アイテムの戻り値と同一ですので、そちらを参照してください。 |
| トピック名: | CONTROL |
| 機 能: | FAX 受信が終了したときに通知されます。 |
| 戻 り 値: | 受信結果を表す文字列を返します。 書式は、[ReceiveFax]アイテムの戻り値と同一ですので、そちらを参照してください。 |
補足
以下のメソッドは、ActiveX コントロールでは利用できますが、DDE 機能では利用できません。
[Connect]、[DisConnect]、[AboutBox]
[GetString]、[GetPrinterName]、[GetPrinterPort]
[GetColorPrinterName]、[GetColorPrinterPort]
[DoExportDialog]、[DoExport]、[GetExportFile]
[AboutBox(エクスポートコントロール)]
それぞれのメソッドの詳細は、「まいと〜く COLOR FAX V6 クライアントの ActiveX コントロール」を参照してください。
索引
* アルファベット順
* 機能から逆引き
* トピック別
( )…トピック名 [C]…コマンド [I]…アイテム
AppExit (CONTROL) [C]
AppFolder (CONTROL) [I]
ClearSendFax (SENDFAX) [C]
CoverFolder (CONTROL) [I]
CoverPage (SENDFAX) [C]
CoverPageMemo (SENDFAX) [C]
FaxFile (SENDFAX) [C]
GroupImageFolder (CONTROL)[I]
GroupSaveFolder (CONTROL)[I]
ImageFolder (CONTROL) [I]
Priority (SENDFAX)[C]
ReceiptNumber (SENDFAX) [I]
Result (SENDFAX) [I]
Result[受付番号] (SENDFAX) [I]
ReceiveFax (CONTROL) [I] ・・・取得
ReceiveFax (CONTROL) [I] ・・・通知
Resolution (SENDFAX) [C]
SaveAs (SENDFAX) [C]
SaveFolder (CONTROL) [I]
SendAbort (SENDFAX) [C]
SendDate (SENDFAX) [C]
SendFaxExecute (SENDFAX) [C]
SendFrom (SENDFAX) [C]
SendTime (SENDFAX) [C]
SendTo (SENDFAX) [C]
SendToV3 (SENDFAX) [C]
SendToV4 (SENDFAX) [C]
Status (SENDFAX) [I]
Status[受付番号] (SENDFAX) [I]