NAME

WWW::CheckPad::CheckItem - A class to control check item of check*pad.

SYNOPSIS

See the WWW::CheckPad

DESCRIPTION

check*padのTodo項目を扱う為のクラスです。APIは極力Class::DBIと 同様のインターフェースを持つように設計されています。

Class Method

retrieve_all_of

  my @checkitems = WWW::CheckPad::CheckItem->retrieve_all_of($chechlist_id);

retrieve_all_ofは与えられたチェックリストの全Todo項目を返します。 通常、このメソッドを直接呼ぶ必要はありません。代わりに WWW::CheckList-checkitems()>で同様に、しかもきれいに書くことが出来ます。

Instance Method

id

  my $checkitem_id = $checkitem->id();
  $checkitem->id(100000);

チェック項目のIDを返します。引数を与えた時は、IDを変更します。

title

  my $checkitem_title = $checkitem->title();
  $checkitem->title('title of check item.');

チェック項目のタイトルを返します。引数を与えた時は、タイトルを変更する。

is_finished

  my $checkitem_is_finished = $checkitem->is_finished();
  $checkitem->is_finished(1);

チェック項目が終了済みであれば、真を返します。そうでなければ、偽を返します。 引数を与えると、変更することが出来ますが、現在ここを変更してもサーバ側のデータに 影響しません。終了状態を変更したい時はfinishかunfinishを利用してください。

finished_time

  my $checkitem_finished_time = $checkitem->finished_time();
  $checkitem->finished_time(time());

（もし、このチェック項目が終了済みであれば）チェック項目の終了時間を返します。 引数を与えると、変更する事が出来ますが、事実上意味がありません。

checklist

  my $checkitem_parent_checklist = $checkitem->checklist();
  $checkitem->checklist($checklist);

このチェック項目が所属するチェックリストを返す。この値はサーバから取得した際に自動的に セットされます。後から変更しても、所属するチェックリストが変わるわけではありません。

update

  $checkitem->update();

このメソッドを呼ぶとこのTodo項目の情報をアップデートします。現在、変更できる 値亜はタイトルだけなので、次のように使うことが多いと思います。

  $checkitem->title('update title'); ## update the title
  $checkitem->update();

delete

  $checkitem->delete();

このTodo項目を削除します。

finish

  $checkitem->finish();

このTodo項目の状態を”終了”にします。これは即座に反映されます。

unfinish

  $checkitem->unfinish();

このTodo項目の状態を”未終了”にします。これは即座に反映されます。

SEE ALSO

WWW::CheckPad

WWW::CheckPad::CheckList

AUTHOR

Ken Takeshige, <ken.takeshige@gmail.com>

http://d.hatena.ne.jp/ya_ken/

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Ken Takeshige

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

cpanm WWW::CheckPad

perl -MCPAN -e shell
install WWW::CheckPad